代码看板 Code kanban

中文 | English

只需一个页面，管理你所有的终端和和AI编程工具(claude code/codex)。

核心特性 • 快速体验 • 开发指南 • 关于

快速体验

立即试用：

npx codekanban
# 或
npm install -g codekanban

核心特性

• 🚀 开箱即用
  单文件部署，本地数据库，双击即可运行。

• 📊 多项目多终端管理
  一个页面统一管理所有项目和终端（快捷键 `）。

• 🔍 AI 编程工具状态检测
  自动识别 Claude Code / Codex 等工具的运行状态（空闲/工作中/需审批），任务完成时自动提醒。

• 📜 历史记录
  记录你对 AI 的讲话，一键回溯修改历程，自动添加为任务。

• 📋 任务看板
  可视化方式管理开发任务，清晰直观。

• 🌿 Worktree 管理
  简单支持了 worktree 分支的创建与管理，帮助你进行并行开发。

• 📝 笔记功能
  支持多标签页笔记，随手记录灵感与问题（快捷键 1）。

开发指南

环境要求

• Node.js: v20.19.0+ 或 v22.12.0+
• Go: 1.24.6+
• 包管理器: pnpm（推荐）

安装依赖

前端依赖：

cd ui
pnpm install

后端依赖：

go mod tidy

开发运行

前端开发服务器：

cd ui
pnpm dev

访问地址：http://localhost:5173

后端开发服务器：

go run . # 注意，初次运行后会生成config.yaml，端口3007，由于跟正式版本冲突，无法同时运行，建议改为3005。以下当作已经修改

• 服务端口：http://localhost:3005
• OpenAPI 文档：http://localhost:3005/docs
• 健康检查：http://localhost:3005/api/v1/health

可选参数：

• -m 或 --migrate：强制执行数据库迁移
• -i 或 --install：安装为系统服务
• --uninstall：卸载系统服务

生产构建

完整构建（推荐）：

python build.py

此脚本会自动完成以下步骤：

1. 构建前端（pnpm build）
2. 将前端产物复制到 static/ 目录
3. 构建 Go 可执行文件（带优化）

手动构建：

# 构建前端
cd ui && pnpm build

# 构建后端
go build -ldflags="-s -w" -trimpath -o CodeKanban

构建产物：

• 前端：ui/dist/ → static/ (移动到此目录后，构建后端会自动存入可执行文件，实现单文件启动)
• 后端：CodeKanban.exe（Windows）或 CodeKanban（Linux/macOS）

访问应用

开发环境：

• 前端开发服务器：http://localhost:5173
• 后端 API：http://localhost:3005

生产环境： 运行构建后的可执行文件，访问 http://localhost:3007

关于

我们处在一个日新月异也异常撕裂的时代，我们的作品也是如此。

这个工具切实的提升了我的效率，但也许效率的提升也会减少工作需求，而AI的发展会消灭这个行业。

不管怎么说，希望大家用的开心。

如果有帮到你，可以点点star或者给我一点赞助。

未来可能的一些功能

• 移动端支持
• 代码清理: 如前端的src/api，应当全走自动生成
• 完成提醒功能，例如AI干完之后播放个声音，告诉你已经弄好了。
• 空闲终端列表 / 待交互终端列表。