名称: terminals 描述: “通过TabzChrome REST API生成和管理终端标签页。用于生成工作者、以编程方式创建终端、设置并行工作的工作树，或为Claude工作者编写提示。”

TabzChrome终端管理

生成终端、管理工作者，并编排并行Claude会话。

生成API

TOKEN=$(cat /tmp/tabz-auth-token)
curl -X POST http://localhost:8129/api/spawn \
  -H "Content-Type: application/json" \
  -H "X-Auth-Token: $TOKEN" \
  -d '{"name": "Worker", "workingDir": "~/projects", "command": "claude"}'

响应:

{
  "success": true,
  "terminalId": "ctt-default-abc123",
  "tmuxSession": "ctt-default-abc123"
}

生成选项

字段	类型	默认值	描述
`name`	字符串	“Claude Terminal”	标签页显示名称
`workingDir`	字符串	`$HOME`	起始目录
`command`	字符串	-	生成后运行的命令
`profileId`	字符串	default	外观配置文件

并行工作者与工作树

# 创建隔离的工作树（bd自动处理珠子重定向）
bd worktree create feature-branch

# 在该处生成工作者，设置BEADS_WORKING_DIR以使用MCP工具
PROJECT_DIR=$(pwd)
curl -X POST http://localhost:8129/api/spawn \
  -H "Content-Type: application/json" \
  -H "X-Auth-Token: $TOKEN" \
  -d "{\"name\": \"Feature Worker\", \"workingDir\": \"../feature-branch\", \"command\": \"BEADS_WORKING_DIR=$PROJECT_DIR claude\"}"

关键: BEADS_WORKING_DIR 告诉珠子MCP服务器在哪里找到数据库。指向主仓库，而不是工作树。

工作者提示

保持提示简单——工作者是标准Claude：

修复useTerminalS.ts中第200行附近的分页错误。
完成后运行测试：npm test
关闭问题：bd close TabzChrome-abc --reason="done"

避免描述性逐步流水线。让Claude自然地工作。

工作者管理

列出工作者

curl -s http://localhost:8129/api/agents | jq '.data[]'

按名称查找

curl -s http://localhost:8129/api/agents | jq -r '.data[] | select(.name == "V4V-ct9")'

获取会话ID

SESSION=$(curl -s http://localhost:8129/api/agents | jq -r '.data[] | select(.name == "V4V-ct9") | .id')

终止工作者

curl -s -X DELETE "http://localhost:8129/api/agents/$SESSION" \
  -H "X-Auth-Token: $TOKEN"

通过tmux发送提示

tmux send-keys -t "$SESSION" -l "您的提示在这里"
sleep 0.5
tmux send-keys -t "$SESSION" Enter

参考

详情见references/：

spawn-api.md - 完整API参考
worktree-setup.md - Git工作树模式
worker-prompts.md - 提示编写指南