克劳德拉班德

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

发送提示

标志后面的位置参数作为提示连接起来。阻塞直到 Claude 完成所有工具调用,然后退出。

交互式 REPL

启动读取-评估-打印循环。向同一会话发送多个提示而无需重新启动。按Ctrl+D退出,按Ctrl+C取消当前提示。

列出会话

列出目录的可恢复会话(默认为cwd)。每行输出:<sessionId> <date> <title>。会话存储在~/.claude/projects/<encoded-cwd>/<sessionId>.jsonl。仅当文件 >= 100 字节时,会话才会出现在此处。

恢复会话

通过 UUID 恢复上一个会话。 (可选)立即发送新提示。

旗帜

标志 · 短 · 默认 · 描述 --help · -h · - · 显示用法并退出 --interactive · -i · false · REPL 模式 --cwd <dir> · - · cwd · 会话工作目录 --claude "<flags>" · -c · - · Claude CLI 启动标志,例如--model sonnet --effort high

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
94 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@halfwhey · MIT
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Node.js · Bun
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# Claudraband CLI

Claudraband spawns Claude Code in a hidden shared tmux session, tails its JSONL log, and provides a clean command-line interface for sending prompts, streaming output, and managing sessions.

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

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

---

## Commands

### Send a prompt

```bash
node packages/claudraband-cli/dist/bin.js "your prompt here"
```

Positional args after flags are concatenated as the prompt. Blocks until Claude finishes all tool calls, then exits.

### Interactive REPL

```bash
node packages/claudraband-cli/dist/bin.js -i
```

Starts a read-eval-print loop. Send multiple prompts to the same session without restarting. Exit with `Ctrl+D`, cancel current prompt with `Ctrl+C`.

### List sessions

```bash
node packages/claudraband-cli/dist/bin.js sessions [--cwd <dir>]
```

Lists resumable sessions for a directory (defaults to `cwd`). Output per line: `<sessionId>  <date>  <title>`.

Sessions are stored at `~/.claude/projects/<encoded-cwd>/<sessionId>.jsonl`. A session only appears here if the file is >= 100 bytes.

### Resume a session

```bash
node packages/claudraband-cli/dist/bin.js resume <sessionId> [prompt...]
```

Resumes a previous session by UUID. Optionally send a new prompt immediately.

---

## Flags

| Flag | Short | Default | Description |
|------|-------|---------|-------------|
| `--help` | `-h` | - | Show usage and exit |
| `--interactive` | `-i` | false | REPL mode |
| `--cwd <dir>` | - | `cwd` | Working directory for session |
| `--claude "<flags>"` | `-c` | - | Claude CLI launch flags, e.g. `--model sonnet --effort high` |
| `--approve-all` | - | false | Auto-select first permission option |
| `--terminal-backend <backend>` | - | `auto` | `auto`, `tmux`, or `xterm` |
| `--debug` | - | false | Debug logging to stderr |

### Permission modes

- `default` -- prompt user for each tool call
- `plan` -- plan only, no file edits
- `auto` -- bypass all permission checks
- `acceptEdits` -- auto-accept file edits
- `dontAsk` -- skip all confirmations
- `bypassPermissions` -- dangerously skip everything

---

## Session lifecycle

tmux-backed sessions share a tmux session named `claudraband-working-session`. Each Claude session gets its own tmux window named with the Claude session ID, and the CLI sends prompts into that window's pane while tailing the JSONL log for events.

**Turn completion**: detected via 3-second idle timeout after Claude sends a response with no outstanding tool calls. This is not a hard delay -- the idle timer only starts after a response arrives.

**Interruption**:
- `Ctrl+C` while prompt is running -- sends interrupt to Claude, waits for it to finish
- `Ctrl+C` while idle -- stops session and exits
- `Ctrl+D` in REPL -- exits the loop and stops the session

---

## Permission prompts

When Claude requests a tool permission, the CLI prints:

```
Permission: <title>
  <description>
  1. <option> (<kind>)
  2. <option> (<kind>)
```

With `--approve-all`, the first option is selected automatically and prints `-> auto: <option name>`.

If stdin is not a TTY and `--approve-all` is not set, permission is denied automatically.

**Tool kinds shown in prompts**: `read`, `edit`, `execute`, `search`, `fetch`, `think`, `other`.

---

## Output

Events stream to stdout with ANSI color:

- Grey -- assistant text
- Bold yellow -- tool call: `> ToolName`
- Green -- tool result: `+ ToolName`
- Red -- error: `! message`
- Dimmed -- thinking blocks and system messages

Use `--debug` to send diagnostic logs to stderr without polluting stdout.

---

## Common examples

```bash
# One-shot prompt
node packages/claudraband-cli/dist/bin.js "summarize the last 5 commits"

# Interactive with opus
node packages/claudraband-cli/dist/bin.js -i --claude "--model opus"

# Auto-approve all permissions
node packages/claudraband-cli/dist/bin.js --approve-all --claude "--permission-mode auto" "run tests and fix failures"

# Resume a session and continue
node packages/claudraband-cli/dist/bin.js sessions
node packages/claudraband-cli/dist/bin.js resume 550e8400-e29b-41d4-a716-446655440000 "implement what you planned"

# Different working directory
node packages/claudraband-cli/dist/bin.js --cwd /path/to/repo "what does this do?"

# Debug mode to trace events
node packages/claudraband-cli/dist/bin.js --debug "write a function" 2>debug.log
```

---

## Gotchas

- **No prompt and no `-i`** -- exits immediately with an error. Always provide one or the other.
- **Session not in `sessions` list** -- file may be < 100 bytes (e.g. aborted immediately). Check `~/.claude/projects/` directly.
- **`--claude "--permission-mode ..."` change mid-session** -- requires restarting the session (Claude Code reloads on mode change). Don't change it after the first prompt if you need consistency.
- **`--terminal-backend xterm`** -- fallback for environments without tmux. Slightly less reliable for long sessions; prefer `tmux` or `auto`.
- **`--approve-all` with non-TTY stdin** -- `--approve-all` takes precedence. Without it, all permissions are denied when stdin is not a TTY (e.g. piped input).

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。