MCP 服务器

HermitAgent

MCP executor lane for Claude Code, Codex, and Hermes Agent that offloads mechanical repo tasks like edits, tests, and commits to a cheaper or local model.

README

HermitAgent

Hidden expert. Quiet executor.

Hermit is an MCP executor lane for Claude Code, Codex, and Hermes Agent. Your main agent handles planning, review, and conversation; Hermit quietly handles edits, test runs, refactors, commits, and other mechanical execution on a cheaper local or flat-rate model.

How it works

┌──────────────┐
│  Claude Code │──┐
│  (planner)   │  │    ┌──────────────┐   any OpenAI-compatible   ┌───────┐
└──────────────┘  ├───▶│  HermitAgent │ ────────────────────────▶ │  LLM  │
                  │    │  (executor)  │                           └───────┘
┌──────────────┐  │    └──────────────┘
│    Codex     │──┘         ~$0 / flat-rate
│  (planner)   │
└──────────────┘

Claude Code, Codex, or Hermes Agent stays in charge of planning, interviewing, and review. Hermit takes the mechanical path: file edits, test runs, refactors, commits, and MCP-executed follow-through on predictable local or flat-rate execution models. In Claude Code the switch is often one word in a slash command: /foo → /foo-hermit.

Why Hermit stands out:

Keep your best reasoning model on the work that needs judgment, not boilerplate execution.
Use MCP to turn planner decisions into concrete repo changes, tests, commits, and release operations.
Default to predictable local / flat-rate executor routing instead of silently drifting onto a paid hosted fallback.
Work across Claude Code, Codex, and Hermes Agent instead of forcing a single orchestrator stack.

Why not just use Claude Code or Codex directly?

Workflow shape	Claude Code / Codex alone	With Hermit
Planning and review	Strong	Still strong — keep the premium orchestrator where judgment matters
Repetitive repo work	Expensive or token-heavy	Offloaded to a cheaper MCP executor lane
Multi-step follow-through	Manual context handoff	MCP tasks can carry edits, tests, commits, and release ops through
Default execution cost	Can drift onto paid hosted models	Defaults to local / flat-rate executor routing
Team adoption	Tied to one orchestrator workflow	Works as a shared executor layer across Claude Code, Codex, and Hermes Agent

Hermit is not trying to replace your orchestrator. It gives you a second lane: use the premium model for judgment, and use Hermit for the mechanical throughput that makes repositories expensive to operate at scale.

Who Hermit is for

Teams that already like Claude Code or Codex for planning, review, and decision-making, but want a cheaper execution lane for repo mechanics.
Developers who want MCP-driven follow-through on edits, tests, commits, and release chores without spending premium-model tokens on every step.
Repositories that need predictable default routing toward local or flat-rate models instead of surprising hosted fallback costs.
Maintainers who want one shared executor layer even if different contributors prefer different orchestrators.

Who Hermit is not for

People looking for a brand-new premium planner to replace Claude Code or Codex entirely.
Teams that want a single hosted model to do both judgment and execution with no planner/executor split.
Workflows where provider cost predictability, MCP task handoff, and execution-lane separation are not important.

If your pain is not "my orchestrator is smart enough, but too much of its time is spent on repetitive repo labor," Hermit is probably not the right abstraction.

Install

npm install -g @cafitac/hermit-agent
hermit

Requires Node.js 20+ and Python 3.11+. The npm package bootstraps a managed Python runtime under ~/.hermit/ on first run — no repo checkout needed. If Claude Code or Codex integration is still missing, hermit will offer guided setup automatically. You can still run hermit install directly when you want to force the full setup/repair flow.

For CI or smoke checks that must avoid optional external hook installation, use hermit install --yes --skip-agent-learner plus any integration-specific skips you need.

For Hermes Agent orchestration, start with the non-mutating snippet printer:

hermit install --print-hermes-mcp-config — print the exact hermes mcp add ... command without editing ~/.hermes
hermit install --fix-hermes-mcp — explicitly register hermit-channel through the Hermes CLI
hermit install --test-hermes-mcp — run Hermes Agent's live hermes mcp test hermit-channel probe without changing config

Setup guides:

Claude Code: docs/cc-setup.md
Codex: docs/codex-setup.md
Hermes Agent: docs/hermes-setup.md

To upgrade: hermit update

Quick start

hermit-mcp-server   # starts the gateway + MCP stdio server

Then connect your orchestrator:

Claude Code: see docs/cc-setup.md, then run /feature-develop-hermit <task>
Codex: see docs/codex-setup.md
Hermes Agent: see docs/hermes-setup.md

Claude Code remains the most polished slash-command path today, but all three integrations share the same core idea: the orchestrator does judgment, Hermit does the repetitive repo execution over MCP.

Reference skills

Four example skills ship under .claude/commands/. Fork these into your own workflow:

Command	Claude does	Hermit does
`/feature-develop-hermit`	interview + plan	implement + test
`/code-apply-hermit`	read PR review	apply every change
`/code-polish-hermit`	pick what to polish	lint/test loop
`/code-push-hermit`	write PR description	commit + push

See docs/hermit-variants.md to add your own.

Executor LLM

ollama (local, free):

brew install ollama && ollama pull qwen3-coder:30b

z.ai (flat-rate subscription) — add to ~/.hermit/settings.json:

{
  "providers": {
    "z.ai": {
      "base_url": "https://api.z.ai/api/coding/paas/v4",
      "api_key": "<your key>",
      "anthropic_base_url": "https://api.z.ai/api/anthropic"
    }
  }
}

Configuration

~/.hermit/settings.json (created by hermit install):

{
  "gateway_url": "http://localhost:8765",
  "gateway_api_key": "hermit-mcp-…",
  "model": "__auto__",
  "routing": {
    "priority_models": [
      {"model": "glm-5.1"},
      {"model": "qwen3-coder:30b"}
    ]
  }
}

model controls the default model for plain hermit. Set it to __auto__ if you want plain hermit to follow the routing.priority_models order. routing.priority_models is the ordered fallback chain for auto-routing in gateway / interactive flows, and providers that are not configured or installed are skipped automatically. If model is a concrete name like gpt-5.4, plain hermit stays pinned to that model even if you reorder priority_models.

By default, hermit install now keeps Codex out of routing.priority_models and treats it as an explicit opt-in executor path instead of an automatic fallback. This is intentional: local / flat-rate executor models stay the safe default, while Codex remains available when a user explicitly pins it or adds it back to routing. That separation makes billing behavior more predictable, keeps executor defaults aligned with Hermit's "cheap mechanical work" role, and avoids surprising auto-routing onto a paid hosted model.

Architecture

AgentLoop — LLM turn → tool call → result → compact on context fill
Gateway — FastAPI relay in front of the executor (routing, 429 failover, dashboard at :8765)
MCP server — run_task / reply_task / check_task / cancel_task
TUI — optional React+Ink terminal UI for standalone interactive sessions (hermit)

Tests

.venv/bin/python -m pytest tests/

Status

Early, working, MIT. No release cadence guarantees.

License

MIT — see LICENSE.

HermitAgent

README

HermitAgent

How it works

Why not just use Claude Code or Codex directly?

Who Hermit is for

Who Hermit is not for

Install

Quick start

Reference skills

Executor LLM

Configuration

Architecture

Tests

Status

License

See also

推荐服务器