ModelScout

From its catalog listing

Per-task model choice from the models you actually have, so light work stops spending frontier-model tokens and subscription usage limits last longer. A pre_llm_call hook shows a short card for each new task (tier, best-fit model from your keys, subscriptions and live models.dev pricing, and why), then routes the work to a right-sized delegate_task child, up or down tier, asks, or stays, per your defaults. Bundles the modelscout skill and a /modelscout command for settings and a measured savings report.

Good to know before installing

reads and writes ~/.claude/modelscout-profile.json (settings shared with ModelScout on other agents), appends routed-child outcomes (tier, model, status; no goal text) to ~/.claude/modelscout-outcomes.jsonl, and reads the model inventory and catalog JSON beside it plus Hermes's own models_dev_cache.json; it opens Hermes state.db read-only to look up a routed child's model and for the savings report, which also reads Claude Code transcripts read-only. A pre_llm_call hook adds routing instructions to each new task's prompt and can steer work into delegated subagents. In Hermes the plugin code makes no network calls and reads no credentials. On Claude Code, Codex and Gemini CLI (not Hermes), hooks/session_start.py runs scripts/catalog.py in a detached process to fetch the public models.dev catalog weekly, sending no keys or user data (`modelscout: catalog off` disables it). The bundled skill's optional discover-models.sh, run through the terminal tool, reads provider API-key env vars, sends each only to its own provider's list-models endpoint and fetches the public models.dev catalog. No telemetry or self-updating, and no background processes in Hermes.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install modelscout
  2. Said no? Turn it on later:
    hermes plugins enable modelscout
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
AI models & providers · Cost, speed & monitoring
Maintained by
iknowterry (Community)
Needs
No API keys declared
Adds hooks
pre_llm_call subagent_start subagent_stop
Needs Hermes
0.23.0 or newer
Version
0.3.10
In the catalog
2026-11-14
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in ai models & providers

All ai models & providers plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins