CodeKanban：把所有 AI 编程工具集中到一个看板

你现在的工作状态是这样吗？

打开 Claude Code → 一个标签页
打开 Codex → 另一个标签页
打开终端 A → 第三个窗口
打开终端 B → 第四个窗口
打开任务列表 → 第五个窗口
...

十分钟过去了，你还在"切换窗口"

这就是 AI 编程时代的典型工作流。

工具越多，切换成本越高。

🎯 CodeKanban 解决了什么？

CodeKanban 是一个开源工具，做的事很简单但很实用：

「把所有的终端 + AI 编程工具 + 任务管理，集中到一个统一的界面。」

开发者 fy0 的原话是：

“从一个统一的界面管理你的所有终端和 AI 编程工具（Claude Code / Codex）”

🌟 核心特性

1. 多项目 + 多终端管理

传统方式：
- 打开终端 A（Project 1）
- 打开终端 B（Project 2）
- 切换回来再开终端 C（Project 3）
- 记不清哪个终端是干啥的

CodeKanban 方式：
- 一个界面看到所有终端
- 每个终端标记清楚属于哪个项目
- 点击直接进入，热键快速切换（按 ` 键）

2. AI 工具状态自动检测

传统方式：
- Claude Code 在做什么？要自己去看
- 完成了吗？要自己去查
- 需要批准吗？可能没注意到，导致卡住

CodeKanban 方式：
✅ 自动检测 Claude Code / Codex 的状态
✅ 显示：空闲 / 工作中 / 需要批准
✅ 完成时通知（后续会有声音提醒）

3. AI 对话历史记录

不再丢失 prompt 历史。

CodeKanban 会：
- 记录你和 AI 的每个对话
- 支持一键回溯 prompt
- 自动转化为任务

4. 任务看板（Kanban）

可视化管理开发任务

类似 Trello：
- ToDo / In Progress / Done
- 拖拽任务
- 一目了然的进度

5. 工作树（Worktree）管理

支持 Git worktree（并行开发）

例如：
- 在分支 feature-A 工作
- 不切换分支，直接创建另一个 worktree
- 同时在 feature-B 工作
- CodeKanban 自动管理这些 worktree

6. 笔记功能

多标签快速笔记（热键 1）

用处：
- 记录临时想法
- 记录调试过程
- 记录技术细节
- 不用切出去用别的笔记应用

💡 为什么这个工具这么实用？

问题：AI 编程的工具爆炸

2023 年：
- 用 ChatGPT 或 Claude Web 偶尔辅助

2024 年：
- Claude Code 出现了
- Codex 出现了
- 各种本地 Agent 出现了
- 各种 Terminal UI 出现了

2025-2026 年：
- 你需要同时跑多个 AI Agent
- 每个都在不同的标签页
- 加上 5+ 个终端窗口
- 加上任务管理工具
- 加上笔记应用

结果：
你 80% 的时间在"切换工具"
20% 的时间在"真正工作"

CodeKanban 的方案

一个界面统一所有。

你只需要：
1. 打开 CodeKanban
2. 所有终端就在这里
3. 所有 AI 工具的状态就在这里
4. 所有任务就在这里
5. 所有笔记就在这里

切换成本：从"复杂"变成"按一个热键"

🚀 怎么快速开始？

一行命令安装

1
2
3
4
npx codekanban
# 或者
npm install -g codekanban@latest
codekanban

就这么简单。双击运行，本地数据库，开箱即用。

技术栈

前端：Vue 3.5 + TypeScript
后端：Go 1.24
数据库：本地（单文件）
部署：单文件可执行文件

第一次启动

1
2
codekanban
# 访问 http://localhost:3007

然后就可以开始用了。

📊 真实工作流对比

传统工作流

1. 打开 VS Code
2. 在 VS Code 里打开 Claude Code 扩展
3. 打开 iTerm（终端 1）
4. 打开 iTerm（终端 2）
5. 打开 Notion（任务管理）
6. 打开 Obsidian（笔记）
7. 给 Claude Code 一个任务
8. 等待它完成，但我在用终端，不知道啥时候完成
9. 切回 VS Code 看看完成没
10. 再切回终端继续...

时间消耗：30% 在工具切换，70% 在工作

用 CodeKanban

1. 打开 CodeKanban（一个界面）
2. 在 CodeKanban 里看所有终端（都在这）
3. 在 CodeKanban 里看 Claude Code 状态（就在这）
4. 在 CodeKanban 里管理任务（Kanban 在这）
5. 在 CodeKanban 里记笔记（快速笔记在这）
6. 给 Claude Code 一个任务
7. CodeKanban 显示它的状态变化（实时看）
8. 完成时自动通知（后续）

时间消耗：95% 在工作，5% 在工具切换

💪 适合谁用？

强烈推荐

✅ 正在用 Claude Code 做项目的开发者

多项目并行
需要监控 AI 进度
需要一个统一的工作界面

✅ 用多个终端工作的工程师

需要快速切换
需要记录和追踪
需要一个"控制中心"

✅ 需要专注力的人

减少工具切换的干扰
所有重要信息一眼看
热键快速操作

可选

🟡 单项目、单终端的开发者

可能有点大材小用
但 Kanban 和笔记功能仍然有用

🔧 架构特点

为什么是 Go + Vue？

Go 后端：
✅ 单文件可执行
✅ 低内存占用
✅ 快速启动
✅ 天然支持多并发（goroutine）

Vue 3 前端：
✅ 快速响应
✅ 实时更新
✅ 美观的 UI
✅ 支持响应式设计

部署方式

传统 Web 应用：
- 需要 Node.js
- 需要包管理器
- 需要复杂配置
- 占用磁盘空间大

CodeKanban：
✅ 单文件可执行
✅ 本地数据库（无需 PostgreSQL）
✅ 双击运行
✅ 磁盘占用小

📋 核心功能详解

终端管理

- 为每个项目绑定终端
- 快速标签切换（热键 `）
- 支持多标签页
- 实时显示终端输出

AI 工具集成

- 自动检测 Claude Code 状态
- 自动检测 Codex 状态
- 显示：idle / working / needs-approval
- 可扩展到其他 AI 工具

Kanban 看板

- ToDo / In Progress / Done 三列
- 拖拽管理任务
- 任务可关联到项目
- 可从 AI 对话自动创建任务

笔记系统

- 多标签快速笔记（热键 1）
- 支持 Markdown
- 快速搜索
- 不需要切出去

Worktree 管理

- Git worktree 创建
- 基本的分支管理
- 并行开发支持

🎯 使用场景

场景 1：多项目开发

你同时在做 3 个项目：
- 项目 A：Bug fix（终端 1）
- 项目 B：新功能（用 Claude Code）
- 项目 C：代码审查（终端 2）

传统方式：3 个终端 + VS Code + 看板工具 = 5 个窗口
CodeKanban：1 个界面搞定，热键切换

场景 2：使用 AI Agent 做大项目

你用 Claude Code 做一个大特性：
- 给 Claude Code 一个复杂任务
- 去终端测试其他部分
- Claude Code 完成时自动通知
- 查看历史 prompt
- 任务自动添加到 Kanban

全在一个界面。```

### 场景 3：分支并行开发

用 Git worktree，同时开发两个功能：

分支 feature-A 在 worktree-1
分支 feature-B 在 worktree-2
CodeKanban 自动管理这两个工作树
快速在两个分支间切换


---

## 🚀 未来计划

开发者列出的 TODO：

✅ 多项目管理（已有） ✅ 多终端管理（已有） ✅ AI 工具状态检测（已有） ✅ Kanban 看板（已有）

🔄 正在做： □ 移动端支持 □ 代码清理（前端 API 自动生成） □ 完成提醒（声音通知） □ 空闲终端列表 □ 需要交互的终端列表


---

## 💬 开发者的一句话

> "这个工具真的提升了我的效率。
> 但效率提升可能也会减少工作需求。
> AI 的发展也可能消灭这个行业。
> 不管怎样，希望大家喜欢用。"

---

## 🎯 适合场景总结

| 场景 | 适合度 | 原因 |
|------|--------|------|
| **多项目并行** | ⭐⭐⭐⭐⭐ | 一界面统一管理 |
| **使用 Claude Code** | ⭐⭐⭐⭐⭐ | 实时监控状态 |
| **多终端工作** | ⭐⭐⭐⭐⭐ | 热键快速切换 |
| **需要任务管理** | ⭐⭐⭐⭐ | Kanban 看板 |
| **快速笔记** | ⭐⭐⭐⭐ | 多标签笔记 |
| **单项目开发** | ⭐⭐ | 可能有点重 |

---

## 📥 立即开始

### 最快的方式（1 分钟）

```bash
npx codekanban

访问 http://localhost:3007

安装到系统（永久使用）

1
2
npm install -g codekanban@latest
codekanban

从源代码（开发者）

1
2
3
4
git clone https://github.com/fy0/CodeKanban
cd CodeKanban
python build.py
./CodeKanban

🔑 核心优势

开箱即用 — 无需复杂配置，双击运行
轻量级 — 单文件可执行，内存占用小
一界面统一 — 终端、AI 工具、任务、笔记全在一起
热键快速切换 — 减少鼠标移动
实时状态显示 — 知道 AI 工具在干什么
开源 — 完全可定制，MIT 许可

💭 最后

如果你正在用 Claude Code 做多项目开发，CodeKanban 值得一试。

它不是"必需品"，但它会显著改善你的工作流。

一行命令安装，两分钟学会，对你的工作效率有 20-30% 的提升。

这个回报率很划算。

CodeKanban：把所有 AI 编程工具集中到一个看板#

你现在的工作状态是这样吗？#

🎯 CodeKanban 解决了什么？#

🌟 核心特性#

1. 多项目 + 多终端管理#

2. AI 工具状态自动检测#

3. AI 对话历史记录#

4. 任务看板（Kanban）#

5. 工作树（Worktree）管理#

6. 笔记功能#

💡 为什么这个工具这么实用？#

问题：AI 编程的工具爆炸#

CodeKanban 的方案#

🚀 怎么快速开始？#

一行命令安装#

技术栈#

第一次启动#

📊 真实工作流对比#

传统工作流#

用 CodeKanban#

💪 适合谁用？#

强烈推荐#

可选#

🔧 架构特点#

为什么是 Go + Vue？#

部署方式#

📋 核心功能详解#

终端管理#

AI 工具集成#

Kanban 看板#

笔记系统#

Worktree 管理#

🎯 使用场景#

场景 1：多项目开发#

场景 2：使用 AI Agent 做大项目#

安装到系统（永久使用）#

从源代码（开发者）#

🔑 核心优势#

💭 最后#