Terminal coding agent. Single binary ccb. Talks to Anthropic (OAuth or API key), Anthropic-compatible endpoints, ChatGPT Codex (OAuth), OpenAI-compatible endpoints (Ollama, DeepSeek, vLLM, …), and Gemini through one agent loop. macOS, Linux, Windows.
Solo-maintained public derivative of Claude Code; baseline reconstructed from the v2.1.88 sourcemap (2026-03-31). See ATTRIBUTION.md. Not affiliated with Anthropic.
macOS / Linux (also Git Bash / WSL):
curl -fsSL https://raw.githubusercontent.com/Icarus603/claude-code/main/install.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/Icarus603/claude-code/main/install.ps1 | iexNo Node, no Bun, no package manager required. Auto-updates on every startup.
Open a terminal — on macOS press ⌘ Space, type Terminal, hit Enter. On Linux press Ctrl Alt T. On Windows open PowerShell from the Start menu.
Then run:
ccbThat drops you into an interactive REPL. Type any task in plain English and press Enter:
> refactor the auth module to use async/await
> explain what this codebase does
> write tests for src/utils/parser.ts
One-shot mode (no REPL, prints and exits):
ccb -p "what does package.json do?"Continue the last conversation:
ccb --continueInside the REPL:
| Key | Action |
|---|---|
Enter |
Send message |
Shift+Enter |
New line |
Escape |
Cancel current response |
/help |
Show all slash commands |
Ctrl+C |
Exit |
Windows ARM64 is not supported. Use x64 under emulation, or WSL.
A TUI dashboard for orchestrating background sessions. Type:
ccb agentsYou get a live list of every background session grouped by state (Needs input · Working · Done), a dispatch input to launch new ones, and a peek panel for reading any session's recent activity without attaching.
Inside the agents view:
| Key | Action |
|---|---|
Type then Enter |
Dispatch a new background session with that task |
Shift+Enter |
Newline in the dispatch input |
↑ / ↓ |
Move focus between sessions |
→ |
Attach into the focused session |
Space |
Peek the focused session (reply inline without attaching) |
Tab |
Toggle the agents drawer / accept suggestion |
@name / /cmd |
Mention an agent, skill, or repo |
Shift+↑ / Shift+↓ |
Reorder within a bucket |
Ctrl+R |
Rename the focused session |
Ctrl+T |
Pin the focused session to the top |
Ctrl+X |
Stop / delete the focused session (two-step) |
Ctrl+S |
Switch grouping (by state ↔ by directory) |
Ctrl+G |
Open the dispatch buffer in $EDITOR |
| Click | Click a row to focus it; click inside the input to move the cursor |
? |
Open the in-view help overlay |
Esc |
Clear input, then exit |
Ctrl+C |
Confirm-then-exit (background sessions keep running) |
Sessions are PTY-backed and survive after you close the terminal — re-open ccb agents later to find them. Dispatch goes through a spare-worker pool so a fresh session boots in ~0ms when one is ready.
New here? Inside the REPL, type:
/powerup
Ten short interactive lessons walk you through what makes ccb worth using — @ file mentions, permission modes, /rewind and Esc-Esc to undo, background sessions, CLAUDE.md, MCP, skills + hooks, /fork for parallel branches, model dialing, and multi-provider switching. Open one, try it, mark it done. The home banner tracks progress until you've finished all ten.
Requires Bun ≥ 1.3.
git clone https://github.com/Icarus603/claude-code.git
cd claude-code
bun install
bun run dev # hot-reload REPL
bun test
bun run doctor:archdoctor:archandbun testmust pass. No--no-verify.- Commit messages explain why.
- No npm publishing — binary-only by design.
- PRs are reviewed by one maintainer at human pace. No SLA.
- Open an Issue before non-trivial PRs.
# macOS / Linux
rm -rf ~/.local/share/ccb ~/.local/bin/ccb
# Windows (PowerShell)
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Programs\ccb"