by fy0
Manage all your terminals and ai coding agents from one unified page.
# Add to your Claude Code skills
git clone https://github.com/fy0/CodeKanbanManage all your terminals and AI coding tools (Claude Code / Codex) from one unified page.
Core Features • Quick Start • Development Guide • About

Try it instantly:
npx codekanban
# or
npm install -g codekanban@latest
codekanban
🚀 Ready to Use Single-file deployment, local database, double-click to run.
📊 Multi-Project & Multi-Terminal Management
Manage all your projects and terminals from one unified page (Hotkey: `).
🔍 AI Coding Tool Status Detection Auto-detect running status of Claude Code / Codex and other tools (idle/working/needs approval), notify when tasks complete.
📜 History Record your conversations with AI, one-click to trace prompt history, automatically add as tasks.
📋 Task Kanban Visualize development task management, clear and intuitive.
🌿 Worktree Management Basic support for worktree branch creation and management, enabling parallel development.
📝 Notes
Multi-tab notes for quick recording of ideas and issues (Hotkey: 1).
Frontend Dependencies:
cd ui
pnpm install
Backend Dependencies:
go mod tidy
Frontend Development Server:
cd ui
pnpm dev
Access at: http://localhost:5173
Backend Development Server:
go run . # Note: After first run, config.yaml will be generated with port 3007. Due to conflicts with the production version, they cannot run simultaneously. It's recommended to change to 3005. The following assumes it has been changed.
http://localhost:3005http://localhost:3005/docshttp://localhost:3005/api/v1/healthOptional Parameters:
-m or --migrate: Force database migration-i or --install: Install as system service--uninstall: Uninstall system serviceFull Build (Recommended):
python build.py
This script will automatically complete the following steps:
pnpm build)static/ directoryManual Build:
# Build frontend
cd ui && pnpm build
# Build backend
go build -ldflags="-s -w" -trimpath -o CodeKanban
Build Artifacts:
ui/dist/ → static/ (After mov...