Cardex

cardex

**中文** | [English](README.en.md)

[](https://linux.do)

本项目原名 ClaudeGo，2026-07-31 更名为 cardex（旧命令名 `claudego` 仍可通过兼容软链继续用，见下方「快速开始」）。

**把 Claude 订阅的 5 小时限额窗口榨干。** 本地任务队列 + 调度器：任务撞到限额自动挂起并记下重置时间，到点自动 `--resume` 接回**同一个会话**继续干。单个 Go 二进制，无外部依赖，**编排本身不花一分额度**。

cardex add -title "重构鉴权" -dir ~/Projects/myapp -file steps.md   # 把活丢进队列
cardex install-launchd                                            # 之后它自己跑

能办到什么

你的处境	cardex 做的事
限额一撞，人就得守着等窗口重开	自动挂起 + 记住重置时刻，到点自动续跑同一会话——你睡觉时队列在跑
一个目标要手写十几段 prompt	assemble：让 Claude 先调研项目，再把目标拆成 prompt 序列自动入队
几个会话并行干活，进度只在脑子里	brief 回收结构化进度，plan 读实时队列做分工、分工任务自动入队
什么活都用最贵的模型	按任务路由模型：机械活 haiku、常规实现 sonnet、高风险最强档；贵模型只做编排与仲裁
冷却期彻底停摆	冷却期把单步编排卡改道 codex exec（走另一份额度），管线不断档
手里还有 Kimi/GLM/MiniMax 这些订阅在吃灰	引擎档案一键接入（cardex engines add kimi）：钉定主跑或纳入自定义降级链，每家独立冷却独立记账，统一能力分级排序
改完还得自己盯着审	完成后自动派对抗式审核卡；只读审核还能分流到第二台机器跑
“现在到底跑到哪了”	cardex list + Web 看板（kanban / 额度燃尽 / 落地进度）+ 每张卡的事件账本

快速开始

make build && make install     # 编译并装到 /opt/homebrew/bin
cardex init                    # 初始化 ~/.cardex（数据目录可用 CARDEX_ROOT 覆盖；旧变量名 CLAUDEGO_ROOT 仍兼容读一次并提示）
cardex doctor                  # 自检：claude CLI、目录、配置

旧名 `claudego` 命令仍要保留：`make install install-shim` 会额外铺一条 `claudego → cardex` 的兼容软链（`ln -sf`，跟随二进制升级），过渡期用，改名收尾后可移除。

三种最常用的入队方式，挑一个开始：

# ① 步骤已经想清楚了：steps.md 里用单独一行 --- 分隔每一步
cardex add -title "重构鉴权" -dir ~/Projects/myapp -priority 5 -review-after -file steps.md

# ② 只有一个目标：让 Claude 先调研，再自动生成任务序列入队
cardex assemble -dir ~/Projects/myapp "给上传模块加断点续传，含测试"

# ③ 手上的会话刚被限额打断：直接接管续跑（会话 id 用 cardex sessions 查）
cardex adopt  -dir ~/Projects/myapp

让它自己跑起来：

cardex run                   # 先手动跑一轮验证
cardex install-launchd       # 后台调度：每 5 分钟 tick 一次，开机自启（macOS）
cardex list                  # 看板：标题列＝「标题 ▸ 最新进度」
cardex log