router-off — Claude Code skill: what it does, how to install
router-off turns off Weave Router for Codex without removing its configuration. The change takes effect when Codex starts again.
Apache-2.0 ★ 5,622 updated 2026-10-29
npx skills add weave-os/router --skill router-off -a claude-codeWhat router-off does
This skill sends a Codex installation back to its default provider and disables Weave Router routing. Router configuration stays in place, and the user does not need to log out.
When $router-off is invoked, it runs npx --package @weave-os/router -y -- weave-router off --codex{{SCOPE}} and reports the result. The active Codex session keeps its current routing because provider settings are read at startup. The change applies on the next codex launch; $router-on can reverse it.
What it helps with
- turn off Weave Router for Codex
- restore Codex’s default provider
- keep router configuration after disabling routing
- change routing without logging out
Example prompts for the agent
- Turn off Weave Router for Codex with
$router-off. - Switch Codex back to its default provider using
$router-off. - Disable routing and tell me when the change will apply.
How to install router-off
1Skills CLI (Vercel)
npx skills add weave-os/router --skill router-off -a claude-code2Manually: put the files in place
~/.claude/skills/router-off/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/router-off/
1Skills CLI (Vercel)
npx skills add weave-os/router --skill router-off -a codex2Manually: put the files in place
.agents/skills/router-off/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add weave-os/router --skill router-off -a cursor2Manually: put the files in place
.cursor/skills/router-off/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install weave-os/router install/codex-skills/router-off2Manually: put the files in place
.github/skills/router-off/SKILL.md1Skills CLI (Vercel)
npx skills add weave-os/router --skill router-off -a gemini-cli2Platform CLI
gemini skills install https://github.com/weave-os/router --path install/codex-skills/router-offManually: put the files in place
.devin/skills/router-off/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-off
How do I install router-off in Claude Code?
Run npx skills add weave-os/router --skill router-off -a claude-code. The installed skill is then available at ~/.claude/skills/router-off/SKILL.md.
What does router-off do?
It disables Weave Router for the Codex installation and routes Codex to its default provider again without deleting router configuration.
When does router-off change the Codex routing?
The change applies on the next codex launch. The current session keeps its existing routing because Codex reads provider settings at startup.
Source text
SKILL.md · Apache-2.0
---
name: router-off
description: "Route Codex to its default provider again (turn the Weave Router off)."
---
<!-- weave-router managed router-off skill -->
# Turn Weave routing off
When the user invokes `$router-off`, switch this Codex installation off the
Weave Router without logging out or deleting its router configuration.
Run exactly:
```bash
npx --package @weave-os/router -y -- weave-router off --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. It can be reversed with
`$router-on`. Do not uninstall the router or alter any other Codex settings.
© weave-os · Apache-2.0 · weave-os/router