multi-router.aidocs

CLI & Agent Skill

Agent Skill

Letting Claude Code and other coding agents manage Multi-Router through the CLI.

The Multi-Router skill teaches a coding agent, such as Claude Code, how to use mr: which command does what, how to read its output, and which commands need your confirmation first. With the skill installed you can ask the agent in plain language, for example "list my routers" or "add Claude Sonnet as a fallback on the support router", and it runs the commands for you.

The skill ships inside the CLI, so the skill you install always matches your CLI version. Install the CLI and add a profile first (see Installing the CLI).

Claude Code

bash
mr skill install

This writes the skill to ~/.claude/skills/multi-router/SKILL.md, where Claude Code finds it in every project. Start a new Claude Code session to load it. To install it for one project only, put it in that project's skills folder:

bash
mr skill install --dir .claude/skills/multi-router

Other agents

mr skill show prints the skill. Save it wherever your agent reads instructions, for example a skills folder or an AGENTS.md file:

bash
mr skill show > AGENTS.md

What the agent does

ActionBehaviour
ReadingLists and reads configuration freely, using the default profile unless you name another.
ChangingReads the current state first, then sends only the fields you asked to change.
Deleting and disablingShows you the target and asks for confirmation before deleting or revoking anything, and before disabling unless you asked for it directly.
API keysNever asks for, reads or prints an API key. If no profile exists, it asks you to run mr profile add yourself.
The API key sets the limits
The agent can do only what the profile's API key allows. To give an agent read-only access, add a profile with a key whose scopes are read-only (see Scope).

Updating

Run mr skill install again after updating the CLI. It reports whether the skill was installed, updated or already current.

Installing the CLICommands
Was this helpful?