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 support for the Hermes Agent in the tool list and auto-detection.
  • Hermes now appears in available tool IDs and uses a dedicated skills directory path.

• Documentation

  • Updated supported tools documentation with Hermes details, including default skill loading and how to expose project-local skills.

• Tests

  • Added coverage for Hermes detection from supported markers and confirmed it is not 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: b0a92bea-723d-4913-a6be-148efb6a7391

📥 Commits

Reviewing files that changed from the base of the PR and between 546224e and 0bad61c.

📒 Files selected for processing (4)

• docs/supported-tools.md
• openspec/specs/ai-tool-paths/spec.md
• src/core/config.ts
• test/core/available-tools.test.ts

---

📝 Walkthrough

Walkthrough

This PR adds support for the Hermes Agent tool, registering it in the AI_TOOLS configuration with detection paths and a skillsDir, adding a corresponding spec scenario, adding detection tests, and updating documentation to describe the new tool.

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 a Hermes Agent entry to AI_TOOLS with skillsDir: '.hermes', detection paths (.hermes, HERMES.md, .hermes.md), and adds a spec scenario requiring skillsDir to be .hermes for the hermes tool.
Detection tests test/core/available-tools.test.ts	Adds tests verifying getAvailableTools detects Hermes via HERMES.md, .hermes.md, and .hermes/, and confirms no false positive from CONTEXT.md.
Documentation updates docs/supported-tools.md	Adds Hermes Agent row to the tool directory table, a configuration note on skill loading paths, and updates the --tools tool ID list.

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

Possibly related PRs

• Fission-AI/OpenSpec#240: Both PRs extend AI_TOOLS in src/core/config.ts by adding new tool entries following the same pattern.
• Fission-AI/OpenSpec#1003: Both PRs add a new adapterless tool to AI_TOOLS and update its skillsDir/docs/specs for skills-only initialization.

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.}