Autorunne 是一个 repo-local 项目记忆和交接层：让 Codex、Claude Code、Hermes、Cursor、GitHub Copilot 在同一个 Git 仓库里接着做，而不是每次从零解释。
很多人已经在用 AI 写代码，但真实项目最麻烦的不是“让模型写一段代码”，而是：今天做到一半，明天还能不能接上；换一个模型，能不能知道上次做了什么；交付前，能不能看清任务、决策、验证结果和下一步。
Autorunne 解决的是这个问题。
它会在项目里维护一个 .autorunne/ 工作区，把项目上下文、任务、决策、会话记录、推荐命令、验证证据和下一步整理成稳定文件。你仍然用自己熟悉的工具写代码，Autorunne 只负责把项目状态留在仓库本地。
这一版是在 0.6.27 核心交接已通过后的干净度小修：不大改 handoff 逻辑，只把 status / doctor / integration diff 的噪音降下来。
autorunne status会把根目录 mirror 缺失显示为 optional mirror，不再误导为核心 handoff 文件缺失。- 新增
autorunne doctor --handoff，只检查交接一致性；handoff ok 时即使 hooks/pre-commit 没装也退出 0。 - 默认
autorunne doctor区分 Blocking issues 和 Optional warnings，hooks / pre-commit / wrappers / integrations 这类增强安装项不再阻断提交。 - 继续保留 0.6.27 的 changed_files 分类，
.agents/.claude旧 skill version diff 不进入业务 changed_files。
简单说：下一个 agent 看到的是“真正阻断交接的问题”，不是可选安装项或 mirror 噪音。
- 经常用 Codex、Claude Code、Hermes、Cursor 或 Copilot 做开发的人
- 独立开发者、接项目的人、AI 编程课程讲师
- 手里有半成品项目、老项目、客户项目，需要让 AI 快速接手的人
- 不想被某一个编辑器、某一个模型绑死的小团队
- 不是新的聊天机器人
- 不是重型 AI IDE
- 不是“完全替代开发者”的自动化平台
- 不是一套散装 prompt 模板
它更像一个放在仓库里的项目工作台：谁来干活都先看同一份项目状态。
推荐用 pipx：
pipx install autorunne如果你在 VS Code 终端里想一行装好：
curl -fsSL https://raw.githubusercontent.com/HUAFIRE777/autorunne/main/scripts/install.sh | bash当前公开版本：0.6.28
每次发新版后，可以用脚本自动发一条 GitHub Discussions 更新：
python scripts/publish_github_update.py --version 0.6.28先预览、不发布：
python scripts/publish_github_update.py --version 0.6.28 --dry-run脚本使用本机 gh 登录态，不保存 token。
进入你的项目目录。新项目不需要手动 git init，Autorunne 会自动初始化本地 Git 仓库：
autorunne open --with-vscodeautorunne open 会创建或刷新 .autorunne/，并生成给不同 agent 看的入口文件。
之后日常使用很简单：
- 打开项目
- 启动 Codex / Claude Code / Hermes / Cursor / Copilot
- 直接分配任务
- agent 先读
.autorunne/views/START_HERE.md - 完成后用 Autorunne 记录验证结果和下一步
常用收尾命令：
autorunne finish --summary "完成登录修复" --validate "python -m pytest -q" --next "继续做订单筛选".autorunne/
├── state/ # 机器可读的项目状态
├── views/ # 给人和 agent 看的 Markdown
│ ├── START_HERE.md # 新窗口从这里开始
│ ├── PROJECT_CONTEXT.md # 项目背景
│ ├── TASKS.md # 任务状态
│ ├── DECISIONS.md # 已确认的决策
│ ├── COMMANDS.md # 推荐运行命令
│ └── STATUS.md # 当前是否可继续开发
└── bin/ # 可选 wrapper，如 ar-codex / ar-claude / ar-hermes
这些文件默认服务于本地开发和团队交接。你可以按项目需要决定哪些文件提交到 GitHub，哪些只留在本机。
Autorunne 不是替代这些工具，而是让它们共享同一个仓库状态：
- Codex
- Claude Code
- Hermes
- Cursor
- GitHub Copilot
- Gemini
如果你想强制从 Autorunne wrapper 进入，也可以用：
./.autorunne/bin/ar-codex
./.autorunne/bin/ar-claude
./.autorunne/bin/ar-hermes但正常情况下，直接打开你常用的 agent 发任务就行。
目前已经覆盖常见开发项目：
- Node / TypeScript：npm、pnpm、yarn、bun、React、Next.js、Vite、Vue、Nuxt、Svelte
- 多包项目：
frontend/、backend/、contracts/、apps/*、packages/* - Python：pip、poetry、uv、FastAPI、Django、Flask、Streamlit
- 轻量 Python 教学项目：只有
app.py、main.py、tests/也能识别 - Go、Rust、C、C++、CMake 项目
# 第一次接管或恢复项目
autorunne open --with-vscode
# 刷新项目扫描和视图
autorunne sync
# 记录一个来自 agent 的自然语言任务
autorunne ingest --source codex --task "继续支付回调" --next "先补 webhook 测试"
# 开始 / 检查点 / 完成
autorunne start --task "实现支付回调" --next "先写测试"
autorunne checkpoint --summary "已理清 payload" --next "接 handler"
autorunne finish --summary "支付回调完成" --validate "pytest -q" --next "补发布说明"
# 查看当前状态
autorunne status
autorunne doctor建议按下面顺序看：
- GitHub 开源使用手册
- 安装与使用操作手册
- 中文使用说明
- 产品说明书
- 开源宣传手册
- 商业计划书
- 对外定位与销售话术
- 商业稳定性说明
- 0.6.20 PyPI/GitHub 同步发布说明
- 0.6.28 status / doctor 干净度补丁
- 0.6.27 交接 doctor / repair 与 diff 分类加固
- 0.6.26 真实交接状态一致性补丁
- 0.6.25 交接洁净度补丁
- 0.6.24 自动 Git 初始化
- 0.6.23 git init 新手提醒
- 0.6.22 workspace open 日志洁净度打磨
- 0.6.21 finish next_product_task 回退修复
- 0.6.16 状态可视化发布说明
- 与大模型开发对接说明
- English usage guide
0.6.28 在 0.6.27 已通过的核心交接逻辑上继续降噪：新项目仍然可以直接 autorunne open，同时 status/doctor 会更清楚地区分核心 handoff 问题和可选安装项。
更准确地说：Autorunne 现在是一个可持续使用的 Beta 工作流层。它不是最终企业平台，但已经足够支撑真实项目里的“接着做”。
git clone https://github.com/HUAFIRE777/autorunne.git
cd autorunne
python -m venv .venv
source .venv/bin/activate
pip install -e .[dev]
python -m pytest -qMIT