VS Code extension v0.5.0 — usage in the dashboard

The dashboard now surfaces usage from the router's /v1/status: a Tokens column per provider, total tokens served, semantic-cache hits, and (when configured) per-key rate-limit/budget usage.

Pairs with the router's Tier-1 update (PR #2): local-model provider, per-key budgets & rate limits, opt-in semantic caching, and the new /v1/usage endpoint.

Install from the Marketplace or grab the attached .vsix.

VS Code extension v0.4.0 — manage a Dockerized router

Manage a router running in Docker straight from VS Code — no hr on your host needed.

Set the new hermesRouter.dockerContainer setting to your container's name and the controls target the container:

• Add Key / Import Codex → a terminal running docker exec -it <container> hr auth add … (you type the key inside the container — the extension never sees it), then it docker restarts to apply.
• Set Model / Rotation → docker exec <container> hr … then docker restart.
• Restart → docker restart <container> (never hr restart, which would stop the container).

Requires the new :cli image variant run with a volume so changes persist:

docker run -d --name hermes-router -p 8319:8319 -v hermes-data:/app/data -e PROXY_API_KEYS=sk-router-1 shafiq735/hermes-router:cli

Then set hermesRouter.dockerContainer to hermes-router. See the docs.

Install from the Marketplace or grab the attached .vsix.

VS Code extension v0.3.1

Friendlier control errors when the hr CLI isn't installed.

The Restart / Add Key / Model / Rotation commands shell out to the hr CLI, which only exists on Linux/macOS/WSL — not on a Windows host or when the router runs in Docker. They previously failed with a cryptic spawn hr ENOENT / "term 'hr' is not recognized".

The extension now detects a missing hr and shows clear, Docker-aware guidance (set keys via -e <PROVIDER>_API_KEYS=…, use docker restart) with a docs link, instead of the raw error. Monitoring and "use as a model" in Copilot Chat are unaffected and keep working.

Install from the Marketplace or grab the attached .vsix.

VS Code extension v0.3.0 — agent mode (tool calling)

hermes-router now works in Copilot agent mode.

This release adds tool/function calling to the hermes-router language model, so you can use it for agentic coding — running commands, editing files, and calling MCP tools — not just chat.

Use it

1. Install hermes-router-0.3.0.vsix (Extensions → ⋯ → Install from VSIX).
2. Router running + hermesRouter.apiKey set to your PROXY_API_KEYS value.
3. Open Copilot Chat, switch to Agent mode, pick hermes-router in the model picker, and give it a task.

The router automatically routes tool-using requests to tool-capable providers in your pool.

Notes

• Requires VS Code ≥ 1.104 and the GitHub Copilot Chat extension.
• Includes everything from v0.1.0 (status bar + dashboard + hr management) and v0.2.0 (use it as a chat model).

Source: vscode-extension/

VS Code extension v0.2.0 — use it as a model in Copilot Chat

hermes-router is now a model you can pick in VS Code Chat.

This release registers hermes-router as a VS Code Language Model provider, so it appears in Copilot Chat's model picker (and is usable by any vscode.lm consumer). Select it and your prompts route through the router's free pool — with streamed replies.

Use it

1. Install hermes-router-0.2.0.vsix (Extensions → ⋯ → Install from VSIX).
2. Make sure your router is running and set hermesRouter.apiKey to your PROXY_API_KEYS value.
3. Open Copilot Chat → model picker → choose hermes-router.

Notes

• Requires VS Code ≥ 1.104 and the GitHub Copilot Chat extension (for the chat UI).
• v1 streams text replies; agent-mode tool-calling is planned for a later release.
• Plus everything from v0.1.0: status-bar health, the live dashboard, and hr management commands.

Source: vscode-extension/

VS Code extension v0.1.0

First release of the hermes-router VS Code extension — a control panel for your router, right in the editor.

Install

1. Download hermes-router-0.1.0.vsix below.
2. In VS Code: Extensions panel → ⋯ menu → Install from VSIX… → pick the file.
   (or: code --install-extension hermes-router-0.1.0.vsix)
3. Open the hermes-router icon in the activity bar. If your router uses a custom proxy key, set hermesRouter.apiKey in Settings.

Features

• Status bar — providers available / total, at a glance.
• Dashboard — live per-provider health, rating, latency, model(s), key cooldowns, cache hit-rate, rotation mode (auto-refreshing).
• Manage — Restart · Doctor · Update · Add Provider Key · Import Codex login · Set Model(s) · Set Rotation Mode.
• Works with a local or remote (Hugging Face Space) router; control commands require a local hr.

Source: vscode-extension/ · Docs: https://hermes-router.vercel.app