Run parallel coding agents from any terminal.
kobe is an SSH-friendly TUI for turning AI coding work into isolated git worktrees and persistent tmux sessions.

A quick look

readme-v0.7.mp4

kobe opens into a tmux workspace with:

• Tasks - create, switch, archive, rename, retarget.
• Engine - the live AI CLI session.
• Ops - changed files, previews, @file mentions, PR prompts.
• Shell - a normal shell inside the task worktree.

---

Choose your AI engine

Use Settings → Engine to pick which AI CLI kobe should run for a task: claude, codex, gemini, copilot, or your own command.

kobe-setting-enginee.mp4

---

AI agents are useful one at a time. kobe is for when you want five attempts running at once.

Task = git worktree + tmux session + branch

Create a task, send it to claude, codex, or copilot, detach, reattach, compare the worktree, keep the good branch, archive the rest. It runs where your code already lives: your laptop, a devbox, a VPS, or any machine you can SSH into.

ssh devbox
cd repo
kobe

Why try it

• Made for SSH/devboxes - no browser, VNC, or desktop app; the terminal is the product.
• Persistent by default - agents live in tmux, so disconnects do not kill the work.
• Safe parallelism - every attempt gets its own branch and worktree.
• Real environment - agents run next to your dependencies, services, credentials, and build cache.
• Scriptable fan-out - kobe api lets another agent or shell script spawn more tasks.

Install

Requirements: Bun >= 1.3.11, tmux, and at least one engine CLI on PATH (claude, codex, or copilot).

bun install -g @sma1lboy/kobe
kobe

Or:

bunx @sma1lboy/kobe

First task: press n, choose a repo/base branch/engine, then prompt the engine pane. kobe creates the worktree under:

<repo>/.claude/worktrees/<task-slug>/

Useful keys

Key	Action
ctrl+h/j/k/l	Move between Tasks, engine, Ops, and shell panes.
ctrl+q	Detach; tasks keep running in tmux.
ctrl+t	New ChatTab on the same task/worktree.
ctrl+[ / ctrl+]	Previous / next ChatTab.
F2	Rename the current ChatTab.
tmux prefix f	Open the new-task dialog.

More: docs/KEYBINDINGS.md.

Browser dashboard

Prefer a browser? The same tasks, sessions, and terminals are available in a local web UI:

kobe web                 # http://localhost:5173
kobe web --port 5180

It talks to the same daemon as the TUI, so tasks created in either surface show up in both. Architecture lives in docs/design/web-dashboard.md.

Fan out

kobe api fan-out \
  --repo "$PWD" \
  --agents claude:2,codex:1 \
  --prompt "Try three approaches to simplify the auth flow."

Install the companion skill so Claude Code knows when to use kobe api:

npx skills add Sma1lboy/kobe --skill kobe --agent claude-code

If it gets stuck

kobe doctor   # read-only diagnosis
kobe reset    # reset daemon + kobe tmux sessions; does not delete worktrees

Develop

bun install
bun run dev:sandbox
bun run typecheck
bun run lint
bun run test

Start with HANDOFF.md, docs/ARCHITECTURE.md, and packages/kobe/CHANGELOG.md.