# 启动 daemon（后台运行，自动分配端口）
codebuddy daemon start

# 指定端口
codebuddy daemon start --port 8080

# 指定绑定地址（允许远程访问）
codebuddy daemon start --host 0.0.0.0

# 指定权限模式（默认为 delegate 委托模式）
codebuddy daemon start --permission-mode default

# 传递其他标准参数（model、mcp-config 等会自动继承）
codebuddy daemon start --model claude-sonnet-4-20250514 --mcp-config ./.mcp.json

codebuddy daemon status
# {"status":"running","pid":12345,"endpoint":"http://127.0.0.1:51862","startedAt":1775498920401}

codebuddy daemon stop
codebuddy daemon restart

# 后台执行任务
codebuddy --bg "实现登录页面"

# 指定名称（便于查找）
codebuddy --bg --name feature-login "实现登录页面"

# 列出所有活跃 Worker
codebuddy ps

# 查看后台会话日志
codebuddy logs feature-login

# 持续跟踪日志（类似 tail -f）
codebuddy logs feature-login -f

# 附加到后台会话
codebuddy attach feature-login

# 终止后台会话
codebuddy kill feature-login

# 列出所有 Worker
curl http://127.0.0.1:8080/api/v1/workers

# 启动 Daemon
curl -X POST http://127.0.0.1:8080/api/v1/daemon/start \\
  -H "Content-Type: application/json" \\
  -d '{"port": 9090}'

# 查看 Worker 日志（遥测日志）
curl "http://127.0.0.1:8080/api/v1/workers/12345/logs?type=telemetry&tail=100"

# 终止 Worker
curl -X DELETE http://127.0.0.1:8080/api/v1/workers/12345

~/.codebuddy/sessions/
├── 12345.json          # 本地进程（PID 作为文件名）
├── 67890.json          # 另一个本地进程
└── manual-abc123.json  # 手动添加的远程 Worker

{
  "pid": 12345,
  "sessionId": "interactive-12345",
  "cwd": "/home/user/project",
  "startedAt": 1775498920401,
  "kind": "interactive",
  "url": "http://127.0.0.1:8080",
  "mode": "local",
  "version": "2.78.1",
  "hostname": "my-machine"
}

# 注册为系统服务并立即启动 daemon
codebuddy daemon install

# 指定端口和权限模式
codebuddy daemon install --port 8080 --permission-mode bypassPermissions

# 移除系统服务注册
codebuddy daemon uninstall

{
  "status": "running",
  "pid": 42567,
  "endpoint": "http://127.0.0.1:9527",
  "systemService": {
    "installed": true,
    "backend": "launchd",
    "configPath": "/Users/xxx/Library/LaunchAgents/com.codebuddy.daemon.plist"
  }
}

# macOS 原生管理
launchctl list | grep codebuddy
launchctl stop com.codebuddy.daemon
launchctl start com.codebuddy.daemon

# Linux 原生管理
systemctl --user status codebuddy-daemon
systemctl --user stop codebuddy-daemon
systemctl --user start codebuddy-daemon

# Windows 原生管理
schtasks /query /tn "CodeBuddy Daemon"

codebuddy daemon start --port 8080
# 浏览器打开 http://127.0.0.1:8080 即可使用
# 关闭终端后服务仍在运行

# CI 启动
codebuddy daemon start --port 9090

# 其他 CI 步骤调用（body 为 Gateway Protocol 格式，须含 id/type）
curl -X POST http://127.0.0.1:9090/api/v1/runs \\
  -H "Content-Type: application/json" \\
  -H "X-CodeBuddy-Request: 1" \\
  -d '{"id": "run-1", "type": "message", "payload": {"text": "审查这个 PR 的代码变更"}}'
# 响应: {"data": {"runId": "uuid-xxx", "status": "accepted"}}

codebuddy daemon start --host 0.0.0.0 --port 8080
# 同事访问 http://192.168.1.100:8080

codebuddy --bg --name "refactor-auth" "重构认证模块"
codebuddy --bg --name "add-tests" "给 utils 目录补充单元测试"
codebuddy --bg --name "fix-types" "修复所有 TypeScript 类型错误"

# 查看进度
codebuddy ps
codebuddy logs refactor-auth

codebuddy daemon start
# 配合远程控制功能连接微信/企业微信渠道