Newshot

Show HN: Listodo – 每个任务都配一个 AI 智能体的待办清单

Translation(model translation, not the source's own text)

Listodo

Listodo 海报:极简任务列表旁配以单色排版,标题为“本地任务。由智能体驱动的工作。”
Listodo 海报:极简任务列表旁配以单色排版,标题为“本地任务。由智能体驱动的工作。”

Listodo 是一款本地桌面任务追踪器,可以把任务交给智能体执行。用 Markdown 记录任务和清单,在日历上安排时间,并让你选择的一个项目文件夹里,用 Codex 或 Claude Code 运行任意任务。你可以实时查看输出、通过后续追问继续会话,并在审阅结果后把任务标记为完成。所有内容都存储在本地 SQLite 中,无需账号,也没有托管后端。

使用 Go、SQLite、React 和 shadcn/ui 构建。macOS 应用使用系统原生的 WKWebView,而不是 Electron。界面采用 Geist 字体、Lucide 图标、单色调色板和极简任务视图。

安装

下载 macOS 版 Listodo(Apple Silicon) · 需要 macOS 13.3 或更高版本 · .zip · 所有版本

  • 打开 .dmg,把 Listodo.app 拖到“应用程序”快捷方式上。(如果是 .zip,解压后把 Listodo.app 移到“应用程序”中。)
  • 该应用未经过公证,因此 macOS 会阻止首次启动。打开“系统设置”→“隐私与安全性”,点击“仍要打开”,或运行:xattr -dr com.apple.quarantine /Applications/Listodo.app

该应用未经过公证,因此 macOS 会阻止首次启动。打开“系统设置”→“隐私与安全性”,点击“仍要打开”,或运行:


        xattr -dr com.apple.quarantine /Applications/Listodo.app
      

截图

今天 — 按状态分组的任务,带有优先级、逾期日期和快速记录。

Listodo 的“今天”视图,显示逾期、进行中和待办任务
Listodo 的“今天”视图,显示逾期、进行中和待办任务

即将到来 — 用于安排任务的月历,旁边是未安排的工作。

Listodo 的“即将到来”日历,显示已安排的任务和“未安排”列表
Listodo 的“即将到来”日历,显示已安排的任务和“未安排”列表

任务编辑器 — Markdown 笔记和可交互清单,带有截止日期和优先级控件。

Listodo 任务编辑器,显示发布清单、截止日期和优先级控件
Listodo 任务编辑器,显示发布清单、截止日期和优先级控件

运行

需要 Go 1.23+、Node.js 20.19+、npm 和 C 编译器(在 macOS 上,安装 Xcode Command Line Tools)。原生界面需要 macOS 13.3+,以支持较新的 WebKit/CSS 特性。make run 会安装前端锁定的依赖、构建其资源并打开原生应用。

构建一个可以从访达打开的 macOS 应用:


        make package
open build/Listodo.app
      

该 bundle 在本地为开发环境签名。未配置分发签名和公证。原生外壳目前面向 macOS;同一界面可以使用 build/listodo --serve 在浏览器中运行。包括字体和应用图标在内的所有资源都在本地打包。侧边栏、浏览器 favicon 以及 macOS 程序坞/访达中使用的是同一个单色标志。要在 macOS 上从 frontend/public/favicon.svg 重新生成原生图标,请运行 node scripts/generate-icon.mjs(需要前端依赖和 Playwright Chromium)。

功能

  • 今天:从开始日期起仍未完成的任务、今天到期的已安排工作,以及今天完成的任务。
  • 任务记录:一个 Markdown 文本框。纯文本会创建一个任务;顶层的 - [ ] 和 - [x] 行会分别创建一个个未完成或已完成的任务。额外的行会保留为 Markdown 笔记。创建当天会自动成为开始日期,并在后续编辑中保持不变。新任务没有隐含的截止日期;已有的项目、优先级、日期和会话链接都会被保留。
  • 即将到来的日历:点击某个日期,添加截止日期为该日期的任务,包括 Markdown 清单批次。将现有任务从“未排期”拖到某一天,在日期之间移动以重新排期,或拖回“未排期”以移除日期。可切换月份或返回“今天”,按状态搜索和筛选,并切换到“列表”查看未来工作。任务编辑器的“截止日期”字段也可安排、重新安排和清除日期;对现有任务的更改会自动保存。
  • 已完成:已完成的任务,支持搜索和状态筛选。
  • 自动升级:每个逾期的日历日会将有效优先级提高一级,最高为“紧急”。原始优先级保持不变。已完成的任务不会升级。
  • 使用代理运行:从任务的 … → “使用代理运行”菜单中选择 Codex 或 Claude Code,选择项目文件夹,然后启动任务。文件夹会保存在任务上,并在编辑和重启后保留。任务标题和 Markdown 笔记会使用你现有的登录信息发送到 CLI。
  • 查看操作:仅列出由 Listodo 启动的任务运行,包含实时输出、提供方、工作文件夹、会话 ID、状态和“停止”操作。输出会自动跟随新消息;向上滚动可暂停跟随,回到底部可恢复。运行历史保存在本地。任务启动后会移动到“进行中”;你查看结果并将其标记为完成。退出 Listodo 会停止其活动运行。
  • 运行通知:完成和失败的轮次会显示带有“查看运行”的常驻应用内提醒。打包的 macOS 应用在后台时还会发送桌面通知;首次运行时出现提示时请允许通知。点击桌面通知会打开该操作。历史运行和你明确停止的运行不会生成完成提醒。
  • 手动排序:拖动任务旁边的控制柄来重新排列其状态组,或聚焦控制柄并按 Alt+↑ / Alt+↓。顺序在编辑和重启后保留;被搜索隐藏的任务会保持其位置。只有任务列表滚动,标题、筛选器和捕获字段保持固定。
  • 选择并合并:按住 Shift 点击一个任务,然后按住 Shift 点击另一个任务,以按列表顺序选择范围。⌘/Ctrl 点击可切换单个任务。右键点击选中的任务,选择“关闭所选”以完成所选任务,或选择“合并所选”以将其合并。相同的操作会出现在列表上方和 … 菜单中。Escape 清除选择;切换视图或筛选器也会清除选择。
  • 撤销任务更改:⌘Z / Ctrl+Z 或工具栏的撤销按钮可撤销任务创建、编辑、完成、排期、重新排序、删除、关闭和合并。批量关闭或合并算作一步撤销。最后 100 项更改在刷新和重启后仍可撤销。在输入时,该快捷键保持编辑器正常的文本撤销行为。
  • 整理器:将描述转换为建议任务,并将今天的会话与现有列表进行比较。Codex 是默认选项;可选择 Claude。在应用之前,查看每个任务或建议的状态。
  • 历史:记录任务创建、更新、状态更改和删除,与会话活动分开记录。
  • 持久化:将所有更改保存在 SQLite 中,包括任务、完成时间戳、会话摘要、链接和集成设置。从侧边栏导出 JSON 快照。

按 ⌘N 创建任务,按 ⌘K 或 ⌘F 搜索。在快速添加字段中按 Enter 添加任务。粘贴多行内容以打开 Markdown 编辑器,然后按 ⌘Enter 保存。点击其标题可在同一个文本框中编辑标题和笔记,或使用其 … 菜单。完成复选框和开始/暂停按钮会立即保存。状态标签和显示菜单可筛选和排序列表。侧边栏可以折叠,较窄的窗口会优先显示任务列表。

使用编辑器的展开按钮,在不丢失草稿的情况下让编辑器填满窗口的宽度和高度;再次点击可恢复紧凑视图。文本在编辑器内部滚动,而保存控件保持在底部。关联的项目文件夹显示在页脚上方。旗帜菜单可将任务的优先级设为 Low、Normal、High 或 Urgent;从清单创建多个任务时,所选优先级会应用到每个任务。

合并会保留第一个所选任务的标题、身份、项目和文件夹(用其他任务填充空的关联)。其他标题和备注会作为 Markdown 章节追加,并在这些备注中保留不同的项目/文件夹关联。结果使用最高优先级、最早截止日期、合并后的会话链接,以及所有所选运行历史。只要任一来源任务处于打开状态,结果就保持打开;只要任一来源任务正在进行,结果就保持进行中。合并任务前,请停止正在运行的代理。撤销会恢复原始任务和运行关联;它拒绝会覆盖较新冲突数据的更改。撤销涵盖任务更改,不涵盖代理执行或代理更改的文件。

对现有任务的编辑会在短暂停顿后自动保存,包括优先级更改。页脚显示正在保存…、已保存或未保存。保存运行时你可以继续输入。关闭编辑器或按 ⌘Enter 会在关闭前保存最新更改;保存失败会保持草稿打开以便重试。新任务和清单批次通过保存按钮或 ⌘Enter 创建。

任务编辑器会将 Markdown 渲染为可编辑的标题、粗体/斜体/删除线文本、链接、图片、嵌套列表、清单、引用、代码块、表格和水平分隔线。粘贴 Markdown 即可为其设置格式,或输入诸如 ## 、bold 和 - [ ] 之类的快捷方式。Markdown 按钮切换到源文本。任务和代理提示词仍以 Markdown 存储。

方向键和 Shift 选择可在整个文档中移动。Tab / Shift+Tab 缩进或取消缩进列表项,并在表格单元格之间移动;Tab 在代码块中插入空格。⌘B / ⌘I 格式化文本,⌘Z / ⇧⌘Z 撤销和重做,⇧⌘X 切换当前清单项。⌘-单击链接可在浏览器中打开。在 Windows/Linux 上用 Ctrl 代替 ⌘。

前端通过一个仅限回环地址、随机端口的 HTTP 服务器与 Go 通信。每次启动都会创建一个新的 API 令牌;每个 API 请求都必须提供它。现有数据库格式和数据文件夹保持不变。

富文本编辑器在首次打开时加载。常规工作区刷新会加载任务和会话文件夹关联;转录摘要和事件历史保留在 SQLite 中,直到组织器或导出请求时才加载。运行列表加载元数据,而不解码历史日志。空闲的运行列表停止轮询,自动导入和实时输出轮询在窗口隐藏时暂停,窗口再次可见时刷新。代理进程和原生完成通知继续在后台运行。

运行任务代理

任务运行使用已安装的 CLI 和你选择的文件夹。Codex 使用 exec --json,配合 workspace-write 沙箱和非交互式批准;Claude Code 使用 -p --output-format stream-json --permission-mode acceptEdits。现有 CLI 权限仍然适用,权限拒绝会显示在操作输出中。未启用任何权限绕过标志。如果任务需要它无法运行的工具,请在 CLI 中配置命令权限。

在页面之间导航时,运行会继续。关闭应用会停止其进程;被中断应用留下的未完成记录会在下次启动时标记为已中断。失败的运行可以从任务菜单重新启动,并创建新的历史记录。同一时间只有一个代理可以运行给定任务。即使任务之后被删除,操作历史仍会保留任务提示词和最近 128 KiB 的输出。

文章标题:Show HN: Listodo – 一个为每个任务配备 AI 代理的待办清单

正文: 当一次运行结束或被停止时,其输出下方会出现一个 > 提示符。输入后续内容并按 Enter,即可在同一个文件夹中继续同一个 Codex 或 Claude 会话,对话上下文和输出历史都会保留。每个完成的轮次都可以再次通知你。这需要一个已记录的会话 ID;如果 CLI 在创建会话之前就退出了,请从该任务重新开始一次运行。在继续已完成任务的会话之前,请先重新打开这些任务。

本地数据

在 macOS 上,数据库位于:


        ~/Library/Application Support/Listodo/listodo.db
      

在其他平台上,该目录使用操作系统的配置目录。可通过 LISTODO_DATA_DIR 或 build/listodo --data-dir /your/folder 覆盖。SQLite 使用 WAL 日志、完全同步写入和事务;数据库文件仅对你的用户私有。没有遥测。

要制作完整的可恢复备份,请退出 Listodo,然后复制整个数据文件夹,包括所有 listodo.db-wal 和 listodo.db-shm 文件。在应用关闭的状态下恢复该文件夹。JSON 导出用于检查和可移植性;不包含导入 UI。

Harness 集成

在你的终端中安装并登录任一 CLI,然后在 Integrations 中选择它。Listodo 使用该 CLI 已保存的认证,自身不读取凭据文件。仅登录 ChatGPT 桌面应用并不等于安装了 Codex CLI。

  • Codex 非交互式执行:使用 codex exec、只读沙箱、临时执行和 JSON 输出模式调用。组织器运行时禁用用户配置/规则;认证仍然可用。没有硬编码任何模型。
  • Claude Code 程序化执行:以打印模式调用,使用结构化输出、受限设置、无内置工具、无 MCP 服务器。使用已安装 CLI 现有的认证。需要支持这些标志的较新 CLI 版本。

应用会检查 PATH、~/.local/bin、/opt/homebrew/bin、/usr/local/bin 和 ~/.npm-global/bin 以查找 CLI,包括从 Finder 启动时。缺少认证、超时和建议格式错误都会显示为错误。运行可以被取消,并会在三分钟后超时。

导入会话是本地操作,不会调用模型。点击 Prepare suggestions 会把任务描述以及最多 60 条今天导入的会话摘录,通过所选 CLI 发送给其提供商。该调用使用你现有的套餐或 API 计费。在你应用之前,建议绝不会更改任务。

默认的记录文件夹为 ~/.codex/sessions(或 $CODEX_HOME/sessions)和 ~/.claude/projects。两者都可以更改或禁用。窗口可见时,自动同步每分钟运行一次。在你编辑集成设置时它会暂停。未更改的文件会通过一个有界的修改时间和大小缓存跳过;记录内容不会缓存在内存中。未更改的导入会避免数据库写入和 UI 重新加载。

当前的适配器支持 Codex 和 Claude Code。记录格式并非公开的稳定 API,因此解析是尽力而为。每次扫描会读取过去 14 天内最近修改的 400 个 JSONL 文件,并限制在大文件的开头和结尾部分。之前的导入仍保留在 SQLite 中。工具输出和凭据文件不会包含在组织器输入中。标记为“Recently active”的会话意味着观察到了最近未完成的轮次;它并不确认进程仍然存活。会话完成与任务完成是分开的。

开发


        make test
make build
make test-ui
      

运行针对运行历史和重复记录导入的分配与耗时基准测试:


        go test ./internal/desktop ./internal/sessions -run '^$' -bench 'Benchmark(OperationList|Scan)' -benchmem
      

Go 测试覆盖重启持久化、完成历史、基于日期的优先级、transcript 解析、CLI 调用、建议验证、API 授权、导出和任务变更。Runner 测试使用 fixture CLI 可执行文件来验证提示词传递、工作文件夹、流式事件、取消和失败处理,而不会发起付费模型调用。浏览器测试会实际操作 shadcn 界面:创建、启动、完成、重新打开、编辑、删除、搜索、筛选、导航、备份下载、响应式布局、organizer 审查、agent 启动/停止、操作输出、持久化拖拽顺序,以及跨标签页的固定滚动。Organizer 测试使用 fixtures,而不是调用付费模型。

浏览器测试使用临时数据库,并将空状态和填充状态截图写入 build/preview-empty.png 和 build/preview.png。如果尚未缓存,请安装一次 Playwright 的 Chromium:


        cd frontend
npx playwright install chromium
npm test
      

进行前端开发时,先在固定的本地端口启动 Go 服务器,然后在另一个终端启动 Vite:


        go run ./cmd/listodo --serve --listen 127.0.0.1:34115
npm --prefix frontend run dev
      

Vite 会代理 API,并将服务器每次启动生成的 token 注入开发页面。如果使用另一个本地端口,请设置 LISTODO_API_URL。运行浏览器测试前请停止开发服务器,因为浏览器测试会占用端口 34115。

入口点是 cmd/listodo。新的前端位于 frontend/src;包含 shadcn 组件及其许可证。internal/desktop 嵌入构建后的资产、提供 API,并托管原生 macOS 窗口。现有的 Fyne 界面作为旧版源码保留在 internal/ui 中。核心服务仍位于 internal/model、internal/store、internal/sessions 和 internal/harness。要添加另一个 harness,请在 internal/sessions 中实现 transcript 适配器,并在需要时在 internal/harness 中实现 organizer 命令。

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by HN AI
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗