Repository navigation
v0.1.3 - 首个正式版本
核心亮点
围绕 Codex CLI 的永动机包装器:开一个 codex 对话把任务给它,模型干一部分活停了,自动 resume 同一个对话说"继续",循环直到全部做完。
⚠️ 重要:prompt.md 必须包含规划章节
prompt.md 必须明确说明当前状态、从哪里开始、做什么任务,否则大模型会自己幻想。
推荐格式:
## 当前推进状态与建议施工顺序
按当前目录看,已落地文档与待写文档可以这样管理:
- 已完成:
- 第 12 章 `12-REPL状态流转.md`
- 第 13 章 `13-输入框与模式系统.md`
- ...
- 待写:
- 第 22-26 章:继续写会话长期化阶段...
- 第 27-35 章:作为执行能力层连续完成...
- ...
从待写开始写关键点:
已完成列表:让模型知道哪些不用重复待写列表:让模型知道接下来要做什么从待写开始写这句很重要:明确指示起点
安装
从 npm 全局安装(推荐)
npm install -g codex-autoresearch
codex-autoresearch --help从源码安装
git clone https://github.com/congwa/codex-autoresearch.git
cd codex-autoresearch
npm install
npm run build
npm install -g .
codex-autoresearch --help使用方式
1. prompt.md + CLI(推荐)
站在目标项目目录里,准备好一个 prompt.md 文件:
codex-autoresearch --prompt-file ./prompt.md2. 直接传任务文本
codex-autoresearch "请检查当前仓库 TODO,补齐缺失测试并更新 README"3. Shell 薄包装 codex-keep-running.sh
./codex-keep-running.sh ./prompt.md
cat ./prompt.md | ./codex-keep-running.sh -环境变量:
| 变量 | 作用 |
|---|---|
WORKDIR |
实际执行目录 |
STATE_DIR |
状态根目录 |
INTERVAL |
重试间隔 |
MODEL |
模型 |
USE_FULL_AUTO |
是否开启 --full-auto |
恢复、查看状态
# 恢复最近一次任务
codex-autoresearch session resume --last
# 查看最近任务状态
codex-autoresearch session status --last
# 按 session id 继续
codex-autoresearch session resume <session-id>工作流程
用户 → codex-autoresearch → Codex CLI (Worker)
↓
永动机循环:exec → resume "继续" → exec → ...
关键设计:
- 永动机核心循环:
codex exec→ 退出 →codex exec resume "继续"→ 退出 → 循环 - resume prompt 就一个字——"继续",不塞行为约束,不重复任务描述
- CLI 阻塞直到任务完成
状态模型
统一执行引擎把状态写到 .codex-run/<job-id>/,包含:
meta.json- 任务元信息events.jsonl- Codex JSON 事件流runner.log- 执行日志last-message.txt- 最近一轮输出
Completion Protocol
执行引擎要求 Codex 在真正完成时严格输出两行:
- 基于 nonce 反转后的 done token
CONFIRMED: all tasks completed
只有完全匹配才会标记为 completed。
完整更新日志
详见 CHANGELOG.md