@coohu/kanban
v0.1.69
Published
A kanban foundation for coding agents
Maintainers
Readme
npx kanban (Research Preview)
这是对您现有 IDE 的一种替代方案,更适合并行运行多个智能体(agent)及查看代码差异(diff)。每个任务卡片都拥有独立的终端和工作树(worktree),且均由系统自动管理。您可以启用自动提交功能,并将卡片相互关联以构建依赖链,从而自主完成大量工作。
[!注意] Kanban 是一个研究预览版,它利用了 CLI 代理的实验性功能,例如绕过权限和运行时钩子,以实现更高的自主性。我们非常欢迎您在 #kanban 频道中提供反馈。discord.
1. 启动 kanban
# Run directly (no install required)
npx @coohu/kanban
# Or install globally
npm i -g @coohu/kanban
kanban在任意 Git 仓库的根目录下运行此命令。Kanban 会自动检测已安装的 CLI 代理,并在浏览器中启动一个本地 Web 服务器。无需注册账号或进行繁琐配置,开箱即用。
2. 创建任务
您可以手动创建任务卡片,也可以打开侧边栏聊天窗口,让您的智能助手为您将工作拆解为各项任务。Kanban 会在该会话中植入看板管理指令,因此您只需发出指令,即可在看板上添加任务、关联任务或开始执行工作。
3. 关联和自动化
⌘ + 点击卡片即可将其与其他任务关联。当卡片完成并移至回收站时,关联的任务便会自动启动。若结合“自动提交”功能,即可构建完全自主的依赖链:任务完成 → 提交 → 触发下一任务 → 循环往复。让智能体将一项大型任务拆解为能够自动提交的子任务,这种体验堪称奇妙——它会巧妙地进行拆解,既实现并行处理以最大化效率,又将各项任务串联起来,从而确保端到端的自主运行。
4. 开始任务
点击卡片上的“播放”按钮,Kanban 就会专门为该任务创建一个临时的“工作树”(worktree),让开发人员能够并行工作,而无需担心合并冲突。在底层实现上,它还会为 node_modules 等被 Git 忽略的文件创建符号链接,因此你无需为每个项目副本都执行耗时的 npm install 操作。
[!注意] Symlinks (symbolic links)它们是指向另一个文件或目录的特殊“快捷方式”,允许从新位置访问目标,而无需复制数据。这种方式非常适合当前场景,因为在日常工作中,你通常不会修改那些被 Git 忽略(gitignored)的文件;但如果你确实需要修改它们,那就不要使用看板(Kanban)。
在智能体运行过程中,看板利用钩子(hooks)在每张卡片上显示最新消息或工具调用情况,让您无需逐一打开卡片,即可一目了然地监控数百个智能体。
5. 修改审核
点击卡片即可查看该 Agent 的 TUI 以及对应工作树(worktree)中所有变更的差异对比。Kanban 内置了检查点系统,因此您还可以查看相对于您上一条发送消息的变更差异。点击代码行即可添加注释,并将反馈发送回 Agent。
为了轻松测试和调试应用,您可以在设置中创建一个脚本快捷方式(Script Shortcut)。使用诸如 npm run dev 之类的命令,这样您只需点击导航栏上的“播放”按钮即可运行,无需费力记忆命令或让 Agent 代劳。
6. 应用修改
当工作成果满意时,点击 Commit(提交)或 Open PR(发起 PR)。Kanban 会向智能体发送动态指令,将工作区(worktree)的内容提交至基础分支或新的 PR 分支,并智能处理合并冲突。或者,您也可以启用自动提交(auto-commit)或自动发起 PR(auto-PR)功能,跳过人工审核,让智能体在任务完成后直接交付成果。若需清理工作区,可将卡片移至回收站(由于 Kanban 会记录恢复 ID,您随时可以恢复该任务)。
7. 使用 Git 界面进行跟踪
点击导航栏中的分支名称,即可打开完整的 Git 界面,从而浏览提交历史、切换分支,以及执行获取(fetch)、拉取(pull)和推送(push)操作,并实现 Git 状态可视化——这一切都无需离开看板。随着工作的推进,您可以随时掌握团队成员在各个分支上的操作动态。
