cli-contexts — Claude Code skill: what it does, how to install
Manages context engineering settings, RTK filter sets, and conversation sessions via the OmniRoute CLI.
npx skills add cheaper-inference/OmniRoute --skill cli-contexts -a claude-codeWhat cli-contexts does
This skill guides AI assistants on using the omniroute CLI to inspect and configure context pipelines, RTK filters, and session lifecycles. It enables token budget adjustments, context switching via omniroute contexts use, and monitoring of active relay settings.
The skill provides subcommands for three operational areas. The context-eng group handles RTK filtering, testing patterns against files, and setting shrinkage aggression parameters. The contexts group manages remote endpoints, tokens, scopes, and JSON export or import. The sessions group tracks and terminates active conversations.
Commands require the omniroute package installed globally via npm install -g omniroute or executed through npx omniroute. Stored plaintext credentials can be migrated into the operating system keychain using omniroute contexts migrate.
What it helps with
- switch active context environments using
omniroute contexts use - tune token budgets and context shrinkage parameters from the CLI
- test RTK filter patterns against target files
- inspect and expire conversation sessions
- export and import context configurations as JSON files
Example prompts for the agent
- Show the active context details with omniroute contexts current
- Set the context token budget to 4000 using omniroute context-eng set --token-budget 4000
- List and expire active sessions with omniroute sessions expire-all
How to install cli-contexts
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-contexts -a claude-code2Manually: put the files in place
~/.claude/skills/cli-contexts/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cli-contexts/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-contexts -a codex2Manually: put the files in place
.agents/skills/cli-contexts/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-contexts -a cursor2Manually: put the files in place
.cursor/skills/cli-contexts/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cheaper-inference/OmniRoute cli-contexts2Manually: put the files in place
.github/skills/cli-contexts/SKILL.md1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-contexts -a gemini-cli2Platform CLI
gemini skills install https://github.com/cheaper-inference/OmniRoute --path skills/cli-contextsManually: put the files in place
.devin/skills/cli-contexts/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-contexts -a opencodeClaude.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 cli-contexts
How do I install cli-contexts in Claude Code?
Run npx skills add cheaper-inference/OmniRoute --skill cli-contexts -a claude-code in your terminal.
What does cli-contexts do?
It provides the command interface for OmniRoute, allowing agents to configure context pipelines, RTK filters, token limits, and user sessions.
What prerequisites are required for cli-contexts?
You must install the CLI globally via npm install -g omniroute or invoke commands using npx omniroute.
Source text
SKILL.md · MIT
--- name: cli-contexts description: Manage context engineering configurations, RTK filter sets, and conversation sessions from the CLI. Apply context-relay settings and inspect active context pipelines. --- <!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten --> ## Overview Manage context engineering configurations, RTK filter sets, and conversation sessions from the CLI. Apply context-relay settings and inspect active context pipelines. ## Quick install ```bash npm install -g omniroute # or: npx omniroute omniroute --version ``` ## Subcommands ### `context-eng` **Example:** ```bash omniroute context-eng ``` ### `context-eng analytics` **Flags:** - `--period <p>` **Example:** ```bash omniroute context-eng analytics ``` ### `context-eng caveman` **Example:** ```bash omniroute context-eng caveman ``` ### `context-eng config` **Example:** ```bash omniroute context-eng config ``` ### `context-eng show` **Example:** ```bash omniroute context-eng show ``` ### `context-eng set` **Flags:** - `--aggressiveness <n>` - `--max-shrink-pct <n>` - `--preserve-tags <list>` **Example:** ```bash omniroute context-eng set ``` ### `context-eng rtk` **Example:** ```bash omniroute context-eng rtk ``` ### `context-eng config` **Example:** ```bash omniroute context-eng config ``` ### `context-eng show` **Example:** ```bash omniroute context-eng show ``` ### `context-eng set` **Flags:** - `--token-budget <n>` - `--reserve-pct <n>` **Example:** ```bash omniroute context-eng set ``` ### `context-eng filters` **Example:** ```bash omniroute context-eng filters ``` ### `context-eng list` **Example:** ```bash omniroute context-eng list ``` ### `context-eng add` **Flags:** - `--pattern <p>` - `--priority <n>` - `--action <a>` **Example:** ```bash omniroute context-eng add ``` ### `context-eng remove <id>` **Flags:** - `--yes` **Example:** ```bash omniroute context-eng remove <id> ``` ### `context-eng test` **Flags:** - `--file <path>` **Example:** ```bash omniroute context-eng test ``` ### `context-eng raw-output <id>` **Example:** ```bash omniroute context-eng raw-output <id> ``` ### `context-eng combos` **Example:** ```bash omniroute context-eng combos ``` ### `context-eng list` **Example:** ```bash omniroute context-eng list ``` ### `context-eng get <id>` **Example:** ```bash omniroute context-eng get <id> ``` ### `context-eng assignments <id>` **Example:** ```bash omniroute context-eng assignments <id> ``` ### `contexts` **Example:** ```bash omniroute contexts ``` ### `contexts list` List all contexts **Example:** ```bash omniroute contexts list ``` ### `contexts add <name>` Add a new context **Flags:** - `--url <u>` - `--api-key <k>` - `--api-key-stdin` - `--access-token <t>` - `--access-token-stdin` - `--scope <s>` - `--description <d>` **Example:** ```bash omniroute contexts add <name> ``` ### `contexts use <name>` Switch active context **Example:** ```bash omniroute contexts use <name> ``` ### `contexts current` Show the active context (server, auth, scope) **Flags:** - `--name-only` **Example:** ```bash omniroute contexts current ``` ### `contexts show <name>` Show context details **Example:** ```bash omniroute contexts show <name> ``` ### `contexts remove <name>` Remove a context **Flags:** - `--yes` **Example:** ```bash omniroute contexts remove <name> ``` ### `contexts rename <old> <new>` Rename a context **Example:** ```bash omniroute contexts rename <old> <new> ``` ### `contexts export` Export contexts to JSON **Flags:** - `--out <path>` - `--no-secrets` - `--include-secrets` **Example:** ```bash omniroute contexts export ``` ### `contexts import <file>` Import contexts from a JSON file **Flags:** - `--merge` **Example:** ```bash omniroute contexts import <file> ``` ### `contexts migrate` Move legacy plaintext context credentials to the OS keychain **Flags:** - `--yes` **Example:** ```bash omniroute contexts migrate ``` ### `sessions` **Example:** ```bash omniroute sessions ``` ### `sessions list` **Flags:** - `--user <u>` - `--kind <k>` - `--active` - `--limit <n>` **Example:** ```bash omniroute sessions list ``` ### `sessions show <sessionId>` **Example:** ```bash omniroute sessions show <sessionId> ``` ### `sessions expire <sessionId>` **Flags:** - `--yes` **Example:** ```bash omniroute sessions expire <sessionId> ``` ### `sessions expire-all` **Flags:** - `--user <u>` - `--yes` **Example:** ```bash omniroute sessions expire-all ``` ### `sessions current` **Example:** ```bash omniroute sessions current ```
© cheaper-inference · MIT · cheaper-inference/OmniRoute