# Community catalog entry — hermes-model-switcher # # Owner-submitted: the PR author (nicolasestrem) owns and maintains the repo below. # Exact-SHA pin (40-hex, resolves as a COMMIT on the repo). Dashboard-only plugin: # the whole code surface is a Dashboard extension tab served through the plugin host. name: hermes-model-switcher repo: https://github.com/nicolasestrem/hermes-model-switcher sha: d62530d906307154e16ed98bb9b4be10ea6fef56 description: >- Choose models across Hermes profiles from a Dashboard tab: a per-profile picker built on host-supplied model data (SDK-authenticated GET /api/model/options), a preview of provider/model intent across every supported model-selection slot (main, delegation, auxiliary, judge, fallback, MoA, cron, plugin and specialist), and one-click apply or revert with presets. Main-slot preview shows intended provider/model, not the exact persisted diff; the exact diff is shown only after host readback. Disclosure — its apply route reads and edits the profiles' config.yaml (that is the plugin's function) through public seams only: POST /api/model/set for main and compatible auxiliary slots, and public hermes_cli.config load/save under the target home for other slots; credential presence checks use public profile-scoped secret helpers (agent.secret_scope), and profile discovery uses public hermes_constants. The plugin makes no direct third-party requests and opens no provider caches or pricing registries directly, but its browser tab does call the host's /api/model/* routes through the Dashboard SDK, and the host options route may itself initiate provider or pricing I/O even without an explicit refresh request, so reads are not guaranteed cache-only. It runs no shell commands or background processes and reports nothing. The private undo journal stores a full pre-change snapshot of each config it edits, which can contain sensitive fields including embedded credentials. Saved presets also persist reviewed change values, potentially including inline credentials or credential-bearing base URLs, in presets.json (0600) under get_hermes_home()/state/hermes-model-switcher/ (0700). The host write route has no expected-revision check: readback surfaces many foreign edits as recovery_required, but a concurrent same-key edit can be overwritten undetected and full-state deletions retain an unrelated-write race, so not every foreign edit is guaranteed to surface. maintainer: Nico Estrem tier: community category: models docs_url: https://github.com/nicolasestrem/hermes-model-switcher#readme version: "0.3.2" # Fresh 0.3.2 captures at the pinned commit, re-taken after the catalog-row # fix: Dashboard SDK fixture with the # plugin's real backend and Hermes' own /api/model/* routers over an isolated # lab home (provenance in docs/images/catalog-captures.json). screenshots: - https://raw.githubusercontent.com/nicolasestrem/hermes-model-switcher/d62530d906307154e16ed98bb9b4be10ea6fef56/docs/images/model-switcher-0.3.2-dashboard.png - https://raw.githubusercontent.com/nicolasestrem/hermes-model-switcher/d62530d906307154e16ed98bb9b4be10ea6fef56/docs/images/model-switcher-0.3.2-preview.png - https://raw.githubusercontent.com/nicolasestrem/hermes-model-switcher/d62530d906307154e16ed98bb9b4be10ea6fef56/docs/images/model-switcher-0.3.2-operation.png - https://raw.githubusercontent.com/nicolasestrem/hermes-model-switcher/d62530d906307154e16ed98bb9b4be10ea6fef56/docs/images/model-switcher-0.3.2-catalog.png - https://raw.githubusercontent.com/nicolasestrem/hermes-model-switcher/d62530d906307154e16ed98bb9b4be10ea6fef56/docs/images/model-switcher-0.3.2-light.png - https://raw.githubusercontent.com/nicolasestrem/hermes-model-switcher/d62530d906307154e16ed98bb9b4be10ea6fef56/docs/images/model-switcher-0.3.2-narrow.png known_issues: - "Couples at runtime to public Hermes seams that are not stability-guaranteed APIs (the /api/model/* dashboard routes, hermes_cli.config, agent.secret_scope, hermes_constants); a host refactor can break the plugin until it re-pins. Missing upstream seams remain open: a compare-and-save write with an expected-revision check (hermes-agent #142339), a public typed write route for non-main slots (#142340), and a dry-run footprint for exact main-slot previews (#142341)." capabilities: provides_tools: [] provides_hooks: [] provides_middleware: [] requires_env: [] requires_hermes: ">=0.22.3"