Skip to content

docs(handoff): mirror HERMES_AGENT_ENABLE.md from HermesProof - #44

Merged
Ghenghis merged 1 commit into
developfrom
docs/hermes-agent-enable-mirror
May 3, 2026
Merged

Ghenghis merged 1 commit into
developfrom
docs/hermes-agent-enable-mirror

Conversation

@Ghenghis

@Ghenghis Ghenghis commented May 3, 2026

Copy link
Copy Markdown
Owner

Task ID: H3D-V5.3-HERMES-AGENT-ENABLE

Summary

Mirrors the Hermes Agent activation guide from HermesProof PR #20 so users find the docs from either repo.

The bridge itself lives in HermesProof (`src/core/hermes-agent-bridge.mjs`); Hermes3D consumes it via the HermesProof MCP server (`hermes3d-locks` server name).

Documents:

  • All 62 supported provider classes (DeepSeek + MiniMax + SiliconFlow + Anthropic + Cohere + 57 others from the registry pack)
  • Both routing modes: `local_private` (cloud-forbidden, air-gapped) and `hybrid` (DeepSeek/MiniMax cloud + LM Studio/Ollama local)
  • Per-client setup for Claude Code, Codex CLI, KiloCode, Cursor, Windsurf, VSCode+Copilot
  • Security model summary and audit trail instructions

Test plan

  • Doc renders cleanly
  • Verify links work after merge

🤖 Generated with Claude Code

How to activate the Hermes Agent USER bridge on this side. The bridge
itself lives in HermesProof (PR #20); Hermes3D consumes it via the
HermesProof MCP server. Mirror exists so users find activation
instructions from either repo.

Lists all 62 supported provider classes (DeepSeek + MiniMax + SiliconFlow
+ Anthropic + Cohere + 57 others), both routing modes (local_private
and hybrid), per-client setup for Claude Code / Codex CLI / KiloCode /
Cursor / Windsurf / VSCode+Copilot.

Task ID: H3D-V5.3-HERMES-AGENT-ENABLE

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented May 3, 2026

Copy link
Copy Markdown

Warning

Rate limit exceeded

@Ghenghis has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 5 minutes and 42 seconds before requesting another review.

To keep reviews running without waiting, you can enable usage-based add-on for your organization. This allows additional reviews beyond the hourly cap. Account admins can enable it under billing.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 24e44a6d-dc2e-43c4-8246-be32c97da72c

📥 Commits

Reviewing files that changed from the base of the PR and between 3fde207 and 527a23a.

📒 Files selected for processing (1)
  • handoffs/HERMES_AGENT_ENABLE.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/hermes-agent-enable-mirror

Review rate limit: 0/5 reviews remaining, refill in 5 minutes and 42 seconds.

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new documentation file, HERMES_AGENT_ENABLE.md, which provides comprehensive instructions for enabling and configuring the Hermes Agent across various MCP clients like Claude Code, Codex, and Cursor. The documentation covers environment setup, provider routing, and security auditing. The review feedback suggests improving the documentation's portability by replacing environment-specific absolute paths with generic placeholders and correcting a version typo for the DeepSeek provider.

## TL;DR — fastest path

```bash
# 1. Put your API keys in G:\private\.env (NEVER inside any repo)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The absolute path G:\private\.env is specific to a local environment. Using a placeholder or a generic path would make the documentation more portable for other developers.

Suggested change
# 1. Put your API keys in G:\private\.env (NEVER inside any repo)
# 1. Put your API keys in a secure .env file (e.g., ~/.hermes/.env) (NEVER inside any repo)


| # | Provider | env var | endpoint |
|---|---|---|---|
| 1 | DeepSeek (v4) | `DEEPSEEK_API_KEY` | api.deepseek.com |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

"DeepSeek (v4)" appears to be a typo, as the current major version is V3. If this refers to a specific internal version, please clarify; otherwise, updating it to V3 would be more accurate for users.

"mcpServers": {
"hermes3d-locks": {
"command": "node",
"args": ["G:/Github/hermes3d-mcp-lock-orchestrator/src/server.mjs"],

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The absolute path to the MCP server script is environment-specific. It should be replaced with a placeholder (e.g., /path/to/...) to guide users on where to point the command. This also applies to lines 163 and 181.

Suggested change
"args": ["G:/Github/hermes3d-mcp-lock-orchestrator/src/server.mjs"],
"args": ["/path/to/hermes3d-mcp-lock-orchestrator/src/server.mjs"],

@Ghenghis
Ghenghis merged commit 5466d4d into develop May 3, 2026
14 checks passed
@Ghenghis
Ghenghis deleted the docs/hermes-agent-enable-mirror branch May 3, 2026 13:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants