用 Cheap Agent 把实现委派给便宜模型：Opus 规划、测试闸门与 git worktree 落地实操

# 确认 Node 版本（官方要求 20+）
node --version

# Claude Code 路线：交互式登录
npx cheap-agent
# 选服务商时按数字：1 OpenCode Go / 2 OpenRouter / 3 DeepSeek
#                   4 Command Code / 5 OpenCode Zen / 6 Custom endpoint
# 拿不准就选 2 OpenRouter；模型直接回车用推荐值
# 在终端提示里粘贴 API Key（官方说明：不要让 Agent 代你要 Key）

# 非交互 / 按预设登录（官方「let agent install」给出的写法）
npx cheap-agent login --preset openrouter
npx cheap-agent login --preset strongest

# 登录多个服务商后，随时在项目里切换
# /cheapag:provider

# 后续升级
npx cheap-agent@latest

# Claude Code：在项目根目录的新会话里执行一次
/cheapag:allow

# 确认 MCP 已注册（官方「let agent install」第 5 步的验收命令）
claude mcp list          # 应能看到 cheapag

# Codex 路线：装插件后同样授权一次
codex plugin marketplace add muaaz9329/cheap-ag
codex plugin add cheapag@cheap-agent
# 启动 codex 时信任它提示的 3 个 cheapag hooks
$cheapag:allow

# 强制主模型必须把改动交出去，而不是自己又写一遍
/cheapag:hook on         # Codex 用 $cheapag:hook on

# 在 Claude Code 会话里照常提需求（示例）
# 「给 calculateTotal 增加可选的 discount 参数，并补上对应单元测试」
# 主模型会写一段简短任务描述，把实现交给便宜模型

# 另开一个终端，逐步跟踪这次任务的每一步
npx cheap-agent watch

# 命令速查（Claude Code / Codex 对应 $ 前缀）
# /cheapag:status    最近的任务与便宜模型花了多少钱
# /cheapag:model     选 worker 的主模型与回退模型，各带 effort
# /cheapag:clean     清理旧任务目录
# /cheapag:provider  在已登录的服务商之间切换

# 项目里放 cheapag.json（官方 Settings 表，值为默认）
{
  "takeover": "ask",
  "limits": {
    "max_turns": 25,
    "repro_by_turns": 30
  },
  "retention": {
    "unlanded_worktree_days": 2,
    "job_log_days": 7
  }
}

# 常用命令
/cheapag:status      # 最近任务与累计花费
/cheapag:clean       # 清理旧任务目录（retention 在启动时与每小时自动跑）

# 全局配置示例：只改实现用的模型，保留其它已有配置
# ~/.config/cheapag/config.json
{ "models": { "implement": "你的模型名" } }

# 关闭启动时的版本更新检查
CHEAPAG_NO_UPDATE_CHECK=1

# 官方说明：以下调用都要带 root（worktree 的完整路径）
# delegate / research / jobs / land / reply
root = "/abs/path/to/your/worktree"

# 带了 root：任务在该 worktree 里运行、落地、留记录，
#            会话自己所在的那份 checkout 不受影响
# 没带 root：行为不变（在当前仓库）

# 每个 worktree 需要自己的同意记录，二选一
# 1) 在该 worktree 里执行一次 /cheapag:allow
# 2) 复制已有的 .cheapag/consent.json 过去

# 查看当前任务与落地状态
/cheapag:status

# 登录时选 6 Custom endpoint，按提示填：
# URL      : http://127.0.0.1:11434/v1     # Ollama 示例
# API key  : 只在端点需要时填「环境变量名」或「存 Key 的文件」
#            （官方说明 Cheap Agent 自己不读这个 Key）
# Model    : 从端点返回的模型列表里选
# Context window / prices : 可选；不填价格则成本显示 0 美元

# 慢机器上放宽单任务时限（默认 20 分钟）
# cheapag.json 里设 limits.max_minutes

# 更新
npx cheap-agent@latest
codex plugin marketplace upgrade

# 卸载（官方 Update or remove 一节）
claude plugin uninstall cheapag@cheapag
claude mcp remove -s user cheapag
codex plugin remove cheapag@cheap-agent