feat: add Hermes Agent support

[xiaoquisme]

What

Adds Hermes Agent as a supported OpenSpec tool using project-local skills under .hermes/skills/.

Continues the Hermes support work from #1095 and addresses the requested review changes there.

Changes

• Add hermes to AI_TOOLS with skillsDir: '.hermes'
• Detect Hermes from .hermes, HERMES.md, or .hermes.md
• Do not detect Hermes from generic CONTEXT.md
• Document Hermes skill paths, user-facing /openspec-* invocation, and skills.external_dirs setup
• Add available-tools regression coverage for Hermes detection

Validation

• ./node_modules/.bin/vitest run test/core/available-tools.test.ts
• ./node_modules/.bin/tsc --noEmit
• ./node_modules/.bin/eslint src/ (passes with existing warning in src/core/references.ts)
• node build.js

Summary by CodeRabbit

• New Features

  • Added Hermes Agent to the supported tools list with automatic detection and a dedicated ~/.hermes skills directory mapping.
  • Hermes is now included in available tool IDs.

• Documentation

  • Updated supported tools documentation with Hermes tool details, including default skills lookup and how to expose project-local skills via config.

• Tests

  • Added tests to verify Hermes detection from HERMES.md, .hermes.md, and .hermes/, and to confirm it isn’t detected from unrelated files.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 67274fbc-851a-4a7d-800f-2170737b57f8

📥 Commits

Reviewing files that changed from the base of the PR and between 0bad61c and 8c71d3e.

📒 Files selected for processing (3)

• docs/supported-tools.md
• src/core/config.ts
• test/core/available-tools.test.ts

🚧 Files skipped from review as they are similar to previous changes (3)

• test/core/available-tools.test.ts
• docs/supported-tools.md
• src/core/config.ts

---

📝 Walkthrough

Walkthrough

This PR adds Hermes Agent support by registering its detection and skills path, defining the corresponding specification, testing detection markers, and documenting Hermes configuration and CLI usage.

Changes

Hermes Agent Tool Support

Layer / File(s)	Summary
Config and spec definition src/core/config.ts, openspec/specs/ai-tool-paths/spec.md	Adds Hermes Agent to AI_TOOLS with .hermes skills and detection paths, and specifies the same skills directory mapping.
Detection tests test/core/available-tools.test.ts	Tests detection through HERMES.md, .hermes.md, and .hermes/, including metadata assertions and rejection of CONTEXT.md alone.
Documentation updates docs/supported-tools.md	Documents Hermes directory mappings, external skill configuration, and the hermes tool ID.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

• Fission-AI/OpenSpec#217: Both modify src/core/config.ts to add a detectable AI tool.
• Fission-AI/OpenSpec#1266: Both extend AI_TOOLS and add tool-detection tests.
• Fission-AI/OpenSpec#1350: Both add Hermes support across configuration, documentation, specification, and detection tests.

Suggested reviewers: tabishb

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: adding Hermes Agent support.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}