autorunne 0.6.17

Local-first agent development workspace that turns any repo into an Autorunne project.

Autorunne

Autorunne 给 Git 仓库加一层本地项目记忆，让 Codex、Claude Code、Hermes、Cursor、GitHub Copilot 能接着同一个项目往下做。

很多人已经在用 AI 写代码，但真实项目最麻烦的不是“让模型写一段代码”，而是：今天做到一半，明天还能不能接上；换一个模型，能不能知道上次做了什么；交付前，能不能看清任务、决策、验证结果和下一步。

Autorunne 解决的是这个问题。

它会在项目里维护一个 .autorunne/ 工作区，把项目上下文、任务、决策、会话记录、推荐命令和下一步整理成稳定文件。你仍然用自己熟悉的工具写代码，Autorunne 只负责把项目状态留在仓库本地。

适合谁

• 经常用 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.17

30 秒上手

进入你的项目仓库：

autorunne open --with-vscode

这个命令会创建或刷新 .autorunne/，并生成给不同 agent 看的入口文件。

之后日常使用很简单：

1. 打开项目
2. 启动 Codex / Claude Code / Hermes / Cursor / Copilot
3. 直接分配任务
4. agent 先读 .autorunne/views/START_HERE.md
5. 完成后用 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

文档

建议按下面顺序看：

1. GitHub 开源使用手册
2. 安装与使用操作手册
3. 中文使用说明
4. 产品说明书
5. 开源宣传手册
6. 商业计划书
7. 对外定位与销售话术
8. 商业稳定性说明
9. 0.6.17 PyPI/GitHub 同步发布说明
10. 0.6.16 状态可视化发布说明
11. 与大模型开发对接说明
12. English usage guide

当前阶段

0.6.17 已完成 GitHub Release、PyPI、服务器运行环境和真实课程 demo 的基础验证。它适合做公开演示、课程教学、个人项目和早期客户交付流程验证。

更准确地说：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 -q

License

MIT