模型是 CPU，Harness 是 OS。
HarnessX 是我的本地 Agent 运行系统。它通过每天能跑的新版本，回答一个更大的问题：AI-Native / Agent Product 到底长什么样子？
当前最务实的切入口是开发者 CLI：先把这些能力在本地的 hx 命令行中跑通。
- ⚡ 自举迭代：这里是工程现场，不是资料馆。HarnessX 依靠 Agent 协同开发自己。
- 🎯 阶段目标：先把
packages/cli做成一个能持续演进、本地可用的开发者 CLI (hx)。 - 🧠 产品自省：每个版本都必须回答一个小问题：这个能力让 Agent 产品更像一个真实可用的产品了吗？
- 目标：交付本地高频可用的
hx命令行工具。 - 落地：CLI/TUI 终端交互、上下文管理、Agent Loop、本地沙箱及 Tool Registry（读写/Shell/Patch 等权限审批与反馈）。
- 目标：从 CLI 经验过渡到 Desktop / Chat / IDE 插件等 GUI 级的产品判断。
- 落地：沉淀人机协作模式、上下文注入、复杂任务拆解与工具执行反馈的产品方案。
- 目标：形成第一版 AI-Native Agent 产品图景与落地路线。
- 落地：理清“核心产品功能”与“底层工程细节”的边界，确定 HarnessX 的演进方向。
- 🚀 版本交付：以每天发布一个可运行版本为生死线。停手时必须说清楚：今天 HarnessX 增加了什么能力？（详细见本文 Release Notes）
- 🧱 开发破墙：先 build 运行，边做边对照源码。外部上游参考（
references/）仅在卡住时用于“破墙”，不独立消耗时间。 - 🔌 工程沉淀：所有可运行能力直接沉淀到
packages/对应的 pnpm workspace 中。
packages/
cli/ # 🛠️ HarnessX CLI 主包 (hx CLI)
core/
docs/
README.md # docs 目录规则入口
v0.0.1/ # 版本交付文档，文件编号全局递增
references/ # ⚠️ 只读参考 (以 Git Submodule 接入)
codex/ # 📂 OpenAI Codex 上游参考源码
opencode/ # 📂 opencode 上游参考源码
learn-claude-code/ # 📂 Harness / Agent Loop 学习参考
pi/ # 📂 Pi minimal agent harness 参考源码- v0.0.7
- 支持
hx agent在每轮模型调用前压缩工具结果上下文。 - 支持大工具输出落盘到
tmp/harnessx-context/，活跃上下文只保留路径和预览。 - 支持
compact工具触发真实 DeepSeek 摘要压缩。 - 子代理暂不开放
compact，保持父子上下文隔离边界。 - 更多
- 支持
- v0.0.6
- 支持父 Agent 启动时发现
.agents/skills下的项目级技能。 - 支持通过
load_skill按需加载完整技能说明。 - system prompt 只注入技能名称和描述，避免一次性塞入全部技能正文。
- 子代理暂不开放
load_skill，保持 v0.0.5 的隔离边界。 - 更多
- 支持父 Agent 启动时发现
- v0.0.5
- 支持
task工具启动同步子代理。 - 支持子代理使用独立上下文执行局部任务。
- 支持父 Agent 只接收子代理最终结论，避免中间 messages 污染主上下文。
- 子代理仅开放
bash/read_file/write_file/edit_file/glob，不支持递归委派。 - 更多
- 支持
- v0.0.4
- 支持
todo_write写入当前会话的任务清单。 - 支持
pending / in_progress / completed状态展示。 - 支持连续 3 轮未更新 TODO 时自动注入 reminder。
- 支持基于 Ink + React 的终端 UI (TUI) 组件渲染及非 TTY 降级。
- 更多
- 支持
- v0.0.3
- 支持
hx agent "<任务>"通过工具分发表调用 5 个本地工具。 - 支持
bash/read_file/write_file/edit_file/glob。 - 文件工具以当前工作目录为沙箱根，禁止路径逃逸。
- 更多
- 支持
- v0.0.2
- 支持
hx agent "<任务>"通过 DeepSeek function calling 调用 bash，形成最小 Agent Loop。 - 支持模型调用本地 bash，并把
role=tool结果回填给下一轮。 - 更多
- 支持
- v0.0.1
- 支持通过 CLI 的方式和 DeepSeek 持续对话。
- 支持一次执行和进程内多轮 chat。
- 更多
- Docs 说明：