router-on — Claude Code skill: what it does, how to install
router-on switches Codex routing back through Weave Router using the configuration stored on disk. Useful when returning to Weave proxying.
Apache-2.0 ★ 5,622 updated 2026-10-29
npx skills add weave-os/router --skill router-on -a claude-codeWhat router-on does
The skill executes npx --package @weave-os/router -y -- weave-router on --codex{{SCOPE}}. It turns Weave routing back on without touching other Codex settings or re-running the full installer.
Codex checks provider configuration only at launch. Because of this, active sessions will not pick up the update immediately; you must restart codex for routing changes to take effect.
What it helps with
- route Codex back through Weave Router
- re-enable managed router configuration without a full reinstall
- switch the active provider profile back on disk
Example prompts for the agent
- Route Codex back through Weave Router
- Turn Weave routing back on with
$router-on - Run
$router-onto reactivate the router
How to install router-on
1Skills CLI (Vercel)
npx skills add weave-os/router --skill router-on -a claude-code2Manually: put the files in place
~/.claude/skills/router-on/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/router-on/
1Skills CLI (Vercel)
npx skills add weave-os/router --skill router-on -a codex2Manually: put the files in place
.agents/skills/router-on/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add weave-os/router --skill router-on -a cursor2Manually: put the files in place
.cursor/skills/router-on/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install weave-os/router install/codex-skills/router-on2Manually: put the files in place
.github/skills/router-on/SKILL.md1Skills CLI (Vercel)
npx skills add weave-os/router --skill router-on -a gemini-cli2Platform CLI
gemini skills install https://github.com/weave-os/router --path install/codex-skills/router-onManually: put the files in place
.devin/skills/router-on/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about router-on
How to install router-on in Claude Code?
Run npx skills add weave-os/router --skill router-on -a claude-code.
What does router-on do?
It invokes the Weave CLI to re-enable Weave Router for your Codex setup using the existing configuration.
Why does the active Codex session keep the old route?
Codex reads provider settings strictly at startup, so changes take effect only after launching a new codex session.
Source text
SKILL.md · Apache-2.0
---
name: router-on
description: "Route Codex through the Weave Router again (turn it back on)."
---
<!-- weave-router managed router-on skill -->
# Turn Weave routing on
When the user invokes `$router-on`, switch this Codex installation back onto
the Weave Router using the managed configuration already on disk.
Run exactly:
```bash
npx --package @weave-os/router -y -- weave-router on --codex{{SCOPE}}
```
Then report the result and tell the user the change takes effect on their next
`codex` launch — Codex reads its provider config at startup, so the current
session keeps routing as it already was. Do not re-run the installer or alter
any other Codex settings.
© weave-os · Apache-2.0 · weave-os/router