How do I install the Claudraband skill?

Run npx skillmds@latest add tomevault-io/claudraband in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Claudraband safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Claudraband?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Claudraband free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Claudraband?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Claudraband by tomevault-io — Agent Skill

Name: Claudraband
Author: tomevault-io

Claudraband

Use claudraband CLI and daemon workflows programmatically to send prompts, resume sessions, inspect status, and manage live session state. Use when running, scripting, or automating Claude Code via claudraband/`cband`, including startup prompt handling, `--connect` daemon mode, and ACP sessions. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

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.

Source: halfwhey/claudraband — distributed by TomeVault.

---name: claudrabanddescription: Use claudraband CLI and daemon workflows programmatically to send prompts, resume sessions, inspect status, and manage live session state. Use when running, scripting, or automating Claude Code via claudraband/`cband`, including startup prompt handling, `--connect` daemon mode, and ACP sessions. Use when this capability is needed.---# 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)```bashcband "review this diff"# equivalent to: cband prompt```### Send a prompt to a session```bashcband 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```bashcband send --session <id> [--select <choice>] <text...>```Returns immediately after delivery.### Stream events```bashcband watch --session <id> [--pretty] [--no-follow]```### Interrupt a live turn```bashcband interrupt --session <id>```### Inspect and monitor```bashcband status --session <id> [--json]cband last --session <id> [--json]```### Attach to a live session```bashcband attach <session-id>```### List and close tracked sessions```bashcband sessions [--cwd <dir>]cband sessions close <session-id>cband sessions close --cwd <dir>cband sessions close --all```### Daemon mode```bashcband serve [--host 127.0.0.1] [--port 7842]# create new daemon sessions via:cband --connect localhost:7842 "start a migration plan"```### ACP```bashcband 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`:```bashcband 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.---> Source: [halfwhey/claudraband](https://github.com/halfwhey/claudraband) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions