One codebase. Multiple AI agents. Each on its own branch.
Supports Claude Code and OpenAI Codex CLI.
You need: Node.js 18+, pnpm, and at least one of: Claude Code CLI or OpenAI Codex CLI authenticated.
git clone https://github.com/yxwucq/CCUI.git
cd CCUI
pnpm install && pnpm build
pnpm link --global # link to $PATHThen point it at any project:
ccui # current directory
ccui --path ~/my-app # specific project
ccui --port 8080 # custom portAll CLI options
--port <n> Server port default: 3456
--host <addr> Bind address default: localhost
--path <dir> Project directory default: cwd
--no-open Don't auto-open browser
-v, --version Version
-h, --help Help
A web dashboard for Claude Code and OpenAI Codex CLI that enables multi-worktree parallel development. Each session runs a real CLI process (Claude or Codex) in an isolated git worktree on its own branch — fix a bug, add a feature, and refactor a module simultaneously from a single browser tab.
Full interactive terminal with live activity tracking, context panel, and usage stats
Grid view — cost, diff stats, and branch info per session
- Multi-provider — run Claude Code and OpenAI Codex sessions side by side, each with its own provider icon
- Parallel sessions — spawn multiple CLI processes, each in its own xterm.js terminal
- Git worktree isolation — each session forks a new branch + worktree, merge or discard when done
- Attach mode — connect to an existing branch without forking
- Live status — see which sessions are running, waiting for input, or idle
- File browser — browse and diff files across worktrees
- Cost tracking — per-session token usage based on official API pricing (Claude + OpenAI models)
- Custom agents — define system prompts and tool permissions
- 8 themes — Dark, Light, Nord, Dracula, Catppuccin, Solarized, Tokyo Night, Sakura
- 100% local — all data stays in
.ccui/inside your project
Each session spawns a claude or codex CLI process attached to a real PTY. When creating a session, choose your provider — both share the same workspace, git, and cost tracking infrastructure. Sessions can run in two modes:
- Fork — creates a new branch + git worktree from any base. Claude works in complete isolation. When done, merge back or discard.
- Attach — connects to an existing branch directly. Good for continuing work on a feature branch.
Dark · Light · Nord · Dracula · Catppuccin · Solarized · Tokyo Night · Sakura
MIT
Built for developers who think one AI agent isn't enough.
