# Ankh.md

> 仓库地址：https://github.com/Abruptive/Ankh.md
> 作者/组织：Abruptive (Alex Doda)
> 成熟度：experimental
> 分析日期：2026-04-15

## 一句话总结
一个 per-project agent scoping 框架，通过 `.agent/` 文件夹实现项目级 agent 配置隔离——在项目目录运行 `hermes` 自动启动定制 agent，项目外运行则使用默认 agent。

## 项目定位与架构
Ankh.md 解决的是"one size fits all"问题——不同项目需要不同的 model、skills、tools 和 instructions，但 Hermes Agent 默认使用全局配置。Ankh 通过 PATH 级拦截实现透明切换。

架构基于 PATH-based command detection：执行 `hermes` 时，Ankh 检查当前目录是否有 `.agent/` 文件夹，有则运行 patched Hermes 实例（合并全局 `~/.hermes` + 本地 `.agent/config.yaml`），否则启动默认 agent。运行时文件部署到 `~/.agent/extensions/ankh/`。

安装通过 `bun bootstrap` 完成（下载 Hermes、应用补丁、部署到 PATH）。技术栈：Bun + Git + Python 3.11+ + Hermes Agent，目前仅测试 macOS。

## 关键技术特性
- **Per-project scoping**：`.agent/config.yaml` + `.agent/skills/` + `.agent/agent.jsonc` 实现项目级定制
- **配置合并**：全局 `~/.hermes` settings 与本地 `.agent/` overrides 自动合并
- **透明切换**：同一 `hermes` 命令在不同目录自动使用不同配置
- **Multi-agent delegation**：支持 sub-agent spawning
- **内置示例 agent**：docs-explorer、web-researcher、ascii-designer、diagram-maker、plan-writer
- **Agent.so 集成规划**：可选付费会员平台

## 设计亮点与创新
PATH-based 透明拦截是极具创意的设计——用户无需学习新命令，现有的 `hermes` 工作流完全保留。配置合并策略（全局 + 本地覆盖）借鉴了 `.gitconfig` 的分层模式。五个内置示例 agent 降低了上手门槛。团队可通过 Git 共享 `.agent/` 文件夹，实现 agent 配置的版本控制。

## 局限性与风险
仅测试 macOS（Linux 可能兼容但未验证）。多个 Hermes 功能尚不支持：gateway 未测试、cron jobs 和 scoped auth 在开发中、外部平台集成（Telegram/WhatsApp）不支持。需要对 Hermes Agent 打补丁，可能随 upstream 更新而 break。Bun 依赖增加了额外的运行时要求。

## 与生态系统的关联
与 hermes-workspace（全功能 Web GUI）和 Mission Control（多 agent 运维）定位不同——Ankh 是 CLI-native 的项目级 agent 管理方案。诞生于 2026 Nous Research Hermes Hackathon，展示了社区对 per-project agent customization 的需求。未来规划的 Agent.so 平台可能成为 Hermes agent 分享和变现的渠道。