Claudraband

Claudraband CLI

claudraband wraps Claude Code in a controlled terminal workflow for persistent sessions.

The package also installs cband as a shorthand alias.

Local built binary: node packages/claudraband-cli/dist/bin.js or bun packages/claudraband-cli/dist/bin.js

Published binary: cband via npx @halfwhey/claudraband or bunx @halfwhey/claudraband

Commands

Start prompt (default)

cband "review this diff"
# equivalent to: cband prompt

Send a prompt to a session

cband prompt [--session <id>] [--select <choice>] [--connect <host:port>] <text...>

• Without --session, starts a new session.
• With --session, resumes a saved session.
• With --select, answers a pending permission/prompt flow before continuing.
• --select and startup handling are documented under "Prompt and send flags" below.

Send input without waiting

cband send --session <id> [--select <choice>] <text...>

Returns immediately after delivery.

Stream events

cband watch --session <id> [--pretty] [--no-follow]

Interrupt a live turn

cband interrupt --session <id>

Inspect and monitor

cband status --session <id> [--json]
cband last --session <id> [--json]

Attach to a live session

cband attach <session-id>

List and close tracked sessions

cband sessions [--cwd <dir>]
cband sessions close <session-id>
cband sessions close --cwd <dir>
cband sessions close --all

Daemon mode

cband serve [--host 127.0.0.1] [--port 7842]
# create new daemon sessions via:
cband --connect localhost:7842 "start a migration plan"

ACP

cband acp [--model opus]

cband acp runs claudraband as an ACP stdio server.

Common flags

• --session <id> — resume (prompt, send) or target (watch, interrupt, status, last) a session
• --cwd <dir> — working directory filter for new sessions and sessions
• --model <model> — haiku, sonnet, or opus
• --permission-mode <mode> — default, plan, auto, acceptEdits, dontAsk, bypassPermissions
• --auto-accept-startup-prompts — auto-resolve startup prompts (trust-folder / bypass-permissions)
• --backend <auto|tmux|xterm> — xterm is still experimental
• -c, --claude "<flags>" — passthrough Claude flags
• --json — JSON output for status, last, watch
• --pretty — human-readable watch output
• --no-follow — exit after next turn_end for live sessions
• --connect <host:port> — route new sessions through daemon
• --select <choice> — answer a pending question/permission prompt on a session

Prompt/select behavior

--select is supported on prompt and send only.

• Use with --session <id>.
• Values are Claude raw option numbers.
• If a selected option expects free text, pass it after --select:

cband prompt --session <id> --select 3 "new direction"

If a new session hits a startup permission question it will print the session id and then wait for a follow-up --select unless --auto-accept-startup-prompts is enabled.

Gotchas

• prompt --select waits for the turn after selection; send --select is fire-and-forget.
• sessions lists only live tracked sessions from ~/.claudraband/.
• attach and --select require a live tracked session.
• Prefer local usage with tmux for reliability; xterm remains experimental.