oh-my-hermes：为 Hermes Agent 加入证据边界与模型路由
给 Hermes Agent 加一层模型路由、验证和项目记忆，保留原生终端而不修改 Hermes。
GitHub rlaope/oh-my-hermes 更新 2026-09-15 分支 main 星标 2.0K 分叉 162
Python Shell Hermes Agent 模型路由 长期项目记忆 macOS/Linux/Windows

🧭 决策指南

为什么现在热： 无法从材料判断

适合，如果你

  • 你已经使用 Hermes Agent，并需要 108 个 omh-* 专家技能参与编码或验证。
    README“06 · Expert skills seep into the run”：目录包含 108 个 omh-* specialist skills。
  • 你要在 GPT-6 Astra、Claude 5.1、Qwen 等模型之间按工作类别路由。
    README“Highlights”列出 Mixture-of-models routing、Per-family calibration 和具体模型家族。
  • 你需要 HUD 同时追踪 delegated lane 的 model、turn、tokens、cost 和验证状态。
    README“05 · The Oh-My-Hermes interface”明确描述 OMH HUD 的实时字段和 Test · verified 状态。

不适合，如果你

  • 你的工作流不使用 Hermes Agent，因为 OMH 是 Hermes-native skills 之上的运行层。
    README 开头说明 OMH turns a normal Hermes Agent request，并明确 never replacing Hermes。
  • 你要求 Maestro 默认调用 Codex 或 Claude Code，而不是显式选择第二条执行通道。
    README“Highlights”写明 Maestro handoffs 是 opt-in，never the default path。
  • 你不能接受远端安装脚本直接执行，或环境不是 macOS/Linux/Windows PowerShell 5.1+。
    README Quick Start 仅给出 curl|sh 与 PowerShell 5.1+ 的 irm|iex 安装路径。

前置条件

  • 需要 Hermes Agent；README 将 OMH 描述为 Hermes-native skills 之上的 operating layer。 / Hermes Agent is required; the README describes OMH as an operating layer above Hermes-native skills.
  • macOS/Linux 可使用 curl 安装；Windows 需要 PowerShell 5.1+。 / macOS/Linux use curl installation; Windows requires PowerShell 5.1+.
  • 安装后必须运行 `omh setup`。 / Run `omh setup` after installation.

第一步命令（README 原文）

curl -fsSL https://raw.githubusercontent.com/rlaope/oh-my-hermes/main/install.sh | sh

要注意

  • `omh update` 会按所属安装器升级命令包，并刷新 managed skills、plugin bundle 和 Hermes registration。
    README Quick Start 的 Update 段落。
  • 完整移除不能只执行包管理器删除，需先运行 `omh uninstall --all`。
    README“Manual package-manager fallback or removal”明确说明删除命令包会保留 OMH state。
  • 只有 host 确认成本为零时才显示 0，否则未定价调用显示 unknown。
    README“05 · The Oh-My-Hermes interface”中的成本显示规则。

替代方案

  • Hermes Agent：只需要 Hermes 原生自然语言界面，不需要 OMH 的 108 个技能、HUD 或项目记忆时更直接。
    README 开头与“05 · The Oh-My-Hermes interface

材料未说明

  • 材料未说明 Hermes Agent 的最低版本、各模型的实际 API 配置和费用表内容。 / The material does not specify the minimum Hermes Agent version, per-model API configuration, or rate-table contents.
  • 材料未提供 108 个技能的完整清单、测试覆盖率或 Hermes alone vs Hermes through OMH 的测量数字。 / The material does not provide the full 108-skill list, test coverage, or measurement figures for Hermes alone vs Hermes through OMH.
  • 材料未说明支持的模型供应商凭证格式、网络要求和本地资源消耗。 / The material does not specify credential formats, network requirements, or local resource usage.

💡 深度解析

6
适合 我已经在使用 Hermes Agent，并需要处理大型多语言仓库中的重构、测试和上线任务；我能否用 OMH 确认任务是真的执行并验证过，而不是只得到模型声称完成的结果？
适合读者： 已经使用 Hermes Agent、维护大型多语言代码库并需要区分计划、执行和验证状态的软件工程师

适合，因为 OMH 的主要价值就是把计划、实际执行和验证结果分开记录。

  • 工作流按 Understand → Research → Decide → Plan → Execute → Verify → Operate → Learn 分阶段运行；准备好的交接不会被当作执行证据。
  • 终端行会显示 Plan · not run、Code · reported done 和只有验证门通过后才出现的 Test · verified。
  • 验证阶段依据测试结果、审查发现、CI 状态和运行时证据，而不是只采信执行器自报状态。
  • 这对重构和多阶段交付尤其有用，但 README 没有保证验证门能覆盖所有项目特有的正确性问题，也没有说明会自动接入哪些 CI 或部署系统。
  • The workflow：Execute 阶段说明“a prepared handoff is not execution evidence”
  • 05 · The Oh-My-Hermes interface：`Plan · not run`、`Code · reported done`、`Test · verified`
  • The workflow：Verify 阶段依据测试结果、审查发现、CI 状态和运行时证据
omh setup
材料未说明：README 未说明默认提供哪些具体验证门；README 未说明如何连接特定 CI、部署平台或生产运行时
视情况 我需要同时处理前端、后端和性能任务，希望减少等待时间；OMH 的并行执行是否适合这些任务，还是会增加合并和验证风险？
适合读者： 希望在大型仓库中并行拆分前端、后端和性能任务、但要求避免文件冲突的软件工程师

视情况：当任务可以按不重叠文件边界拆分时适合；如果多个任务频繁修改同一文件或共享强依赖上下文，就不适合并行。

  • OMH 的 fanout 单元要求明确的文件所有权边界，并通过准入控制、类型化结果和验证门回收结果。
  • 专业技能覆盖前端、后端、Rust、性能预算和验证，因此任务类型本身可以被路由到不同能力。
  • TUI 会为每个 delegated lane 显示模型、轮次、令牌、成本和实时状态，便于观察并行运行。
  • 但项目限制明确指出，并行不适合强耦合架构修改、同一文件频繁编辑或严格顺序的迁移；README 也未承诺自动解决所有合并冲突。
  • 04 · Parallel where it is safe, typed when it comes back（README 章节目录）
  • 项目洞察：并行任务使用不重叠文件所有权、准入控制、类型化结果和验证门
  • 06 · Expert skills seep into the run：技能覆盖 frontend、backend、Rust、performance budgets 和 verification
  • 项目限制：并行不适合强耦合修改、同一文件频繁编辑或严格顺序迁移
omh doctor
材料未说明：README 未说明并行 lane 的最大数量和默认资源限制；README 未说明冲突发生后是否提供自动合并或回滚机制
适合 我们保留 Hermes 作为主要交互入口，同时使用 Codex 和 Claude Code 处理不同代码任务；OMH 能否让每个执行器的代码所有权、运行状态和交接结果保持清晰？
适合读者： 需要把 Codex 或 Claude Code 接入 Hermes、但要求明确代码所有权和交接状态的软件工程团队

适合，因为 OMH 把 Codex 和 Claude Code 定义为可选的外部执行器，而不是隐藏替换 Hermes 的编码入口。

  • README 明确表示 Hermes 仍是自然语言界面，OMH 只是其上的 operating layer。
  • Maestro 交接提供就绪探测、能力快照、所有权适配，以及每次运行的模型和推理配置。
  • Hermes TUI 会为通过 Maestro 交接的 lane 单独显示一行，并标注 (codex/maestro …) 或 (claude/maestro …)。
  • 并行任务要求文件所有权边界和类型化结果；但 README 没有说明外部 CLI 的凭据隔离、沙箱策略或所有权限审计，因此企业安全控制仍需自行补足。
  • README 开头：OMH “never replacing Hermes or hiding a coding executor behind it”
  • Maestro 外部执行器交接：支持 Codex、Claude Code、就绪探测、能力快照和所有权适配
  • 05 · The Oh-My-Hermes interface：Maestro lane 有独立行并标注 `(codex/maestro …)` 或 `(claude/maestro …)`
  • 04 · Parallel where it is safe, typed when it comes back（README 章节目录）
omh doctor
材料未说明：README 未说明 Codex 和 Claude Code 各自支持的版本范围；README 未定义外部 CLI 凭据、沙箱和权限审计的具体实现
适合 我只能在 Windows PowerShell 5.1+ 上运行 Hermes Agent，希望安装 OMH、完成模型配置并在之后更新或排错；这个项目是否适合我的环境？
适合读者： 在 Windows PowerShell 5.1+ 环境中运行 Hermes Agent、需要跨平台安装和维护 OMH 的个人开发者

适合，README 明确提供 Windows PowerShell 5.1+ 安装路径，并配套 setup、update 和 doctor 命令。

  • Windows 快速安装命令使用 install.ps1，不是只支持 macOS/Linux 的 shell 脚本。
  • 安装后必须运行 omh setup；模型类别配置通过 omh model 完成，故障排查使用 omh doctor。
  • 项目还列出 npm、Bun、手动安装等路径，说明命令包不局限于单一 Unix 包管理器。
  • 但 README 没有说明 PowerShell 环境下 Hermes Agent、模型认证和外部 Maestro CLI 的完整兼容矩阵；如果你依赖 Codex 或 Claude Code，仍需分别确认其 Windows 支持。
  • Quick Start：Windows (PowerShell 5.1+) 使用 `install.ps1`
  • Quick Start：安装后必须执行 `omh setup`
  • Quick Start：`omh update` 和 `omh doctor`
  • Other installation paths：Bun、npm、manual fallback
irm https://raw.githubusercontent.com/rlaope/oh-my-hermes/main/install.ps1 | iex
材料未说明：README 未给出 PowerShell 5.1+ 下 Hermes Agent 的完整版本兼容矩阵；README 未说明 Codex、Claude Code 在 Windows 上的具体支持状态
适合 我长期维护一个项目，需要保存架构决策、约束和经过确认的经验，但不想让未经审查的内容写入 Hermes 自有记忆；OMH 是否能满足这种记忆治理要求？
适合读者： 需要长期维护项目上下文、但不希望错误事实污染 Hermes 原有记忆的高级个人开发者

适合，OMH 提供与 Hermes 自有记忆隔离的文件型项目记忆，并把写入放在审查和准入流程之后。

  • README 的长期记忆设计强调“a reviewer admitted”，即记忆不是模型自动写入的无条件事实库。
  • 项目洞察说明记忆支持审查后写入、准入与保留策略，以及带新鲜度和预算控制的召回包。
  • Learn 阶段会把经过审查、范围明确的经验提升为项目记忆或工作流改进。
  • 这适合可审查的项目上下文，但 README 没有把它定位为向量数据库、企业知识库或跨组织权限系统，也没有说明多人并发审查的具体流程。
  • 08 · A long-term memory that a reviewer admitted（README 章节目录）
  • The workflow：Learn 阶段将 reviewed、scoped lessons 提升为 project memory
  • 项目洞察：记忆采用文件型、带准入和保留策略，并与 Hermes 自有记忆隔离
  • 项目限制：不等同于高性能向量数据库、企业知识库或跨组织权限管理系统
omh setup
材料未说明：README 未说明记忆文件的默认存储位置和加密方式；README 未说明多人协作时谁拥有记忆审核权限
视情况 我同时使用多个模型供应商，需要为前端、后端、安全审查和验证任务分别选择模型，并关注令牌成本；OMH 是否比在 Hermes 中手工切换模型更合适？
适合读者： 同时使用多个模型供应商、希望按工作类别控制模型、推理强度和成本的高级 Hermes 用户

视情况：如果你的任务确实跨越多个工作类别，OMH 更合适；如果只是偶尔手工切换模型，额外配置可能不值得。

  • omh model 可按工作类别设置模型，并调整 head model 与 effort；路由层还支持模型链、排序和失败回退。
  • README 列出前端、后端、安全审查、性能和验证等专业技能，路由器会把匹配技能加入运行。
  • TUI 会显示模型、轮次、令牌、缓存和成本；无法定价时显示 unknown，不会伪装成零成本。
  • 但成本依赖令牌统计、费率表、供应商信息和账户权限，README 没有证明路由一定降低总费用，也没有给出你的供应商配置。
  • Quick Start：`omh model` 按 work category 设置模型、head model 和 effort
  • 01 · Per-model tuning, task splitting, and stronger coding skills（README 章节目录）
  • 05 · The Oh-My-Hermes interface：显示 model、turn、tokens、cost，未定价显示 `unknown`
  • 06 · Expert skills seep into the run：目录包含 108 个 `omh-*` 专业技能
omh model
材料未说明：README 未提供所有供应商的完整费率表和可用模型清单；README 未说明你的账户权限或配额不足时各模型链的实际回退结果

✨ 核心亮点

  • 108 个 omh-* 技能覆盖编码、验证与安全审查
  • 九类执行器类别支持 omh model-chains set 调序
  • HUD 展示模型、turn、tokens、cost 与验证状态
  • ast-grep 支持 28 种语言并提供代码图谱

🔧 工程化

  • omh setup 在 Hermes Agent 上安装 OMH 运行层
  • omh doctor 检查配置，omh model 选择工作类别模型
  • 并行任务使用 disjoint file ownership 与验证门
  • 长期记忆采用文件存储、审核写入与 freshness 召回包

⚠️ 风险

  • OMH 依赖 Hermes Agent，README 明确不会替换 Hermes
  • Maestro 的 Codex 与 Claude Code 交接是 opt-in，非默认路径
  • 未定价调用显示 unknown，而不是可用的 $0 成本
  • 安装命令使用 curl|sh 或 PowerShell irm|iex，执行前需信任远端脚本

👥 适合谁？

  • 使用 Hermes Agent 并需要模型类别、验证门和项目记忆的团队
  • 需要 GPT-6 Astra、Claude 5.1 或 Qwen 路由的多模型开发者
  • 在 macOS、Linux 或 Windows PowerShell 5.1+ 上运行 Hermes 的用户