skill Claude Code CX Codex Cursor GitHub Copilot
Open on GitHub
omni-settings — Claude Code skill: what it does, how to install
Inspects and updates global OmniRoute settings, including system prompts, thinking budgets, IP filters, and proxy rules.
Install into Claude Code · Skills CLI (Vercel)
All methods and platforms ↓
npx skills add cheaper-inference/OmniRoute --skill omni-settings -a claude-codeWhat omni-settings does
The skill connects coding agents to the OmniRoute administrative API. It exposes HTTP endpoints to inspect and adjust system prompts, thinking budgets, PII filtering rules, and proxy settings directly from the terminal.
Under the hood, it interacts with routes for cache management, Qdrant vector storage maintenance, database vacuuming, and JSON configuration exports. Any call will fail without a valid Bearer token or session cookie unless REQUIRE_API_KEY=false is configured for local development.
What it helps with
- update thinking budgets and system prompts via API
- configure IP filtering and payload rules
- monitor and clean up Qdrant vector storage
- export active application settings to JSON
Example prompts for the agent
- Check the Qdrant health status using the omni-settings endpoints.
- Update the thinking budget configuration in OmniRoute.
- Export the current application settings to JSON.
How to install omni-settings
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-settings -a claude-code2Manually: put the files in place
~/.claude/skills/omni-settings/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/omni-settings/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-settings -a codex2Manually: put the files in place
.agents/skills/omni-settings/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-settings -a cursor2Manually: put the files in place
.cursor/skills/omni-settings/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cheaper-inference/OmniRoute omni-settings2Manually: put the files in place
.github/skills/omni-settings/SKILL.md1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-settings -a gemini-cli2Platform CLI
gemini skills install https://github.com/cheaper-inference/OmniRoute --path skills/omni-settingsManually: put the files in place
.devin/skills/omni-settings/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill omni-settings -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set34
The whole set →
cli-setup Helps the agent configure OmniRoute, manage autostart, apply CLI updates, and adjust session environment variables.
Claude Code CX Codex Cursor +1
1,200installs
omni-combos-routing This skill creates and manages model routing combos with fallback chains, tests, and metrics. Use it when OmniRoute needs configurable provider routing.
Claude Code CX Codex Cursor +1
1,200installs
omni-inference Connects OpenAI-compatible inference endpoints for chat, embeddings, audio, and images. Useful for AI agents calling OmniRoute endpoints.
Claude Code CX Codex Cursor +1
1,100installs
cli-providers Manage OmniRoute provider connections from the CLI: inspect the catalog, test connections, rotate keys, and view metrics. Useful when provider setup is part of your terminal workflow.
Claude Code CX Codex Cursor +1
1,100installs
omni-auth Manage API keys and sessions in OmniRoute. Authenticates requests via Bearer tokens, handles dashboard login with password or OIDC, and controls session access.
Claude Code CX Codex Cursor +1
1,100installs
cli-routing Manage model routing combos from the command line with omniroute. Test routing strategies, inspect metrics, and configure fallback chains interactively.
Claude Code CX Codex Cursor +1
1,100installs
omni-mcp Connects an agent to the OmniRoute MCP server for request routing, memory, cache, and audit work. Use it when those operations need to be available as MCP tools.
Claude Code CX Codex Cursor +1
1,100installs
omni-providers Manages connections to 375 AI providers via REST API: adds keys, tests connections, syncs models.
Claude Code CX Codex Cursor +1
1,100installs
Similar
himalaya Lets an agent work with a mailbox from the terminal through Himalaya CLI. Use it to read, search, send, and organise email.
Claude Code CX Codex Cursor +1
392installs
home-assistant-best-practices Enforces native Home Assistant patterns for AI coding agents: favors built-in helpers, replaces device_id with entity_id, and fixes automation modes.
Claude Code CX Codex Cursor +1
8,600installs
kr-whois-lookup Queries public registration data for .kr domains, IP addresses, and AS numbers via k-skill-proxy. Read-only tool for coding agents.
Claude Code CX Codex Cursor +1
4,200installs
setup-matt-pocock-skills This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills.
Claude Code
1,052,851installs
to-tickets Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker.
Claude Code
711,230installs
writing-plans This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks.
Claude Code CX Codex
282,859installs
caveman-review Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler.
Claude Code CX Codex Cursor +1
410,700installs
caveman-compress Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup.
Claude Code CX Codex Cursor +1
410,300installs
Questions about omni-settings
How do I install omni-settings in Claude Code?
Run npx skills add cheaper-inference/OmniRoute --skill omni-settings -a claude-code.
What does omni-settings do?
It gives your agent an interface to read and update global OmniRoute settings, such as quotas, prompt templates, and proxy routes.
What authentication does omni-settings require?
Requests require a valid Bearer token from POST /api/auth/login or a session cookie. You can bypass this in local environments by setting REQUIRE_API_KEY=false.
Source text
SKILL.md · MIT
---
name: omni-settings
description: "Read and update global application settings: system prompts, thinking budget, IP filters, payload rules, combo defaults, and require-login configuration."
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->
## Overview
Read and update global application settings: system prompts, thinking budget, IP filters, payload rules, combo defaults, and require-login configuration.
## Authentication
All requests require a valid Bearer token or session cookie. Obtain a token via `POST /api/auth/login` or configure `REQUIRE_API_KEY=false` for local development.
## Endpoints
- [`GET /api/settings/memory`](references/endpoints.md#get-apisettingsmemory)
- [`PUT /api/settings/memory`](references/endpoints.md#put-apisettingsmemory)
- [`GET /api/settings/qdrant`](references/endpoints.md#get-apisettingsqdrant)
- [`PUT /api/settings/qdrant`](references/endpoints.md#put-apisettingsqdrant)
- [`GET /api/settings/qdrant/health`](references/endpoints.md#get-apisettingsqdranthealth)
- [`POST /api/settings/qdrant/search`](references/endpoints.md#post-apisettingsqdrantsearch)
- [`POST /api/settings/qdrant/cleanup`](references/endpoints.md#post-apisettingsqdrantcleanup)
- [`GET /api/settings/qdrant/embedding-models`](references/endpoints.md#get-apisettingsqdrantembedding-models)
- [`GET /api/settings`](references/endpoints.md#get-apisettings)
- [`PATCH /api/settings`](references/endpoints.md#patch-apisettings)
- [`POST /api/settings/purge-request-history`](references/endpoints.md#post-apisettingspurge-request-history)
- [`GET /api/settings/compression`](references/endpoints.md#get-apisettingscompression)
- [`PUT /api/settings/compression`](references/endpoints.md#put-apisettingscompression)
- [`GET /api/settings/compression/mcp-accessibility`](references/endpoints.md#get-apisettingscompressionmcp-accessibility)
- [`PUT /api/settings/compression/mcp-accessibility`](references/endpoints.md#put-apisettingscompressionmcp-accessibility)
- [`GET /api/settings/payload-rules`](references/endpoints.md#get-apisettingspayload-rules)
- [`PUT /api/settings/payload-rules`](references/endpoints.md#put-apisettingspayload-rules)
- [`GET /api/settings/combo-defaults`](references/endpoints.md#get-apisettingscombo-defaults)
- [`GET /api/settings/proxy`](references/endpoints.md#get-apisettingsproxy)
- [`PATCH /api/settings/proxy`](references/endpoints.md#patch-apisettingsproxy)
- [`POST /api/settings/proxy/test`](references/endpoints.md#post-apisettingsproxytest)
- [`POST /api/settings/require-login`](references/endpoints.md#post-apisettingsrequire-login)
- [`GET /api/settings/ip-filter`](references/endpoints.md#get-apisettingsip-filter)
- [`PUT /api/settings/ip-filter`](references/endpoints.md#put-apisettingsip-filter)
- [`GET /api/settings/pii`](references/endpoints.md#get-apisettingspii)
- [`PUT /api/settings/pii`](references/endpoints.md#put-apisettingspii)
- [`POST /api/settings/pii/test`](references/endpoints.md#post-apisettingspiitest)
- [`GET /api/settings/system-prompt`](references/endpoints.md#get-apisettingssystem-prompt)
- [`PUT /api/settings/system-prompt`](references/endpoints.md#put-apisettingssystem-prompt)
- [`GET /api/settings/thinking-budget`](references/endpoints.md#get-apisettingsthinking-budget)
- [`PUT /api/settings/thinking-budget`](references/endpoints.md#put-apisettingsthinking-budget)
- [`GET /api/tags`](references/endpoints.md#get-apitags)
- [`GET /api/settings/quota-store`](references/endpoints.md#get-apisettingsquota-store)
- [`PUT /api/settings/quota-store`](references/endpoints.md#put-apisettingsquota-store)
- [`POST /api/settings/purge-usage-history`](references/endpoints.md#post-apisettingspurge-usage-history)
- [`GET /api/settings/authz-inventory`](references/endpoints.md#get-apisettingsauthz-inventory)
- [`GET /api/settings/auto-disable-accounts`](references/endpoints.md#get-apisettingsauto-disable-accounts)
- [`PUT /api/settings/auto-disable-accounts`](references/endpoints.md#put-apisettingsauto-disable-accounts)
- [`GET /api/settings/background-degradation`](references/endpoints.md#get-apisettingsbackground-degradation)
- [`POST /api/settings/background-degradation`](references/endpoints.md#post-apisettingsbackground-degradation)
- [`PUT /api/settings/background-degradation`](references/endpoints.md#put-apisettingsbackground-degradation)
- [`GET /api/settings/cache-config`](references/endpoints.md#get-apisettingscache-config)
- [`PUT /api/settings/cache-config`](references/endpoints.md#put-apisettingscache-config)
- [`GET /api/settings/cache-metrics`](references/endpoints.md#get-apisettingscache-metrics)
- [`DELETE /api/settings/cache-metrics`](references/endpoints.md#delete-apisettingscache-metrics)
- [`GET /api/settings/cc-discovery-metrics`](references/endpoints.md#get-apisettingscc-discovery-metrics)
- [`GET /api/settings/compression/rules`](references/endpoints.md#get-apisettingscompressionrules)
- [`GET /api/settings/compression/run-telemetry`](references/endpoints.md#get-apisettingscompressionrun-telemetry)
- [`GET /api/settings/database`](references/endpoints.md#get-apisettingsdatabase)
- [`PUT /api/settings/database`](references/endpoints.md#put-apisettingsdatabase)
- [`PATCH /api/settings/database`](references/endpoints.md#patch-apisettingsdatabase)
- [`POST /api/settings/database/integrity-check`](references/endpoints.md#post-apisettingsdatabaseintegrity-check)
- [`POST /api/settings/database/refresh-stats`](references/endpoints.md#post-apisettingsdatabaserefresh-stats)
- [`GET /api/settings/database/vacuum`](references/endpoints.md#get-apisettingsdatabasevacuum)
- [`POST /api/settings/database/vacuum`](references/endpoints.md#post-apisettingsdatabasevacuum)
- [`GET /api/settings/export-json`](references/endpoints.md#get-apisettingsexport-json)
- [`GET /api/settings/favicon`](references/endpoints.md#get-apisettingsfavicon)
- [`GET /api/settings/feature-flags`](references/endpoints.md#get-apisettingsfeature-flags)
- [`PUT /api/settings/feature-flags`](references/endpoints.md#put-apisettingsfeature-flags)
- [`DELETE /api/settings/feature-flags`](references/endpoints.md#delete-apisettingsfeature-flags)
- [`GET /api/settings/free-proxies`](references/endpoints.md#get-apisettingsfree-proxies)
- [`DELETE /api/settings/free-proxies`](references/endpoints.md#delete-apisettingsfree-proxies)
- [`POST /api/settings/free-proxies/{id}/add-to-pool`](references/endpoints.md#post-apisettingsfree-proxiesidadd-to-pool)
- [`POST /api/settings/free-proxies/bulk-add-to-pool`](references/endpoints.md#post-apisettingsfree-proxiesbulk-add-to-pool)
- [`GET /api/settings/free-proxies/stats`](references/endpoints.md#get-apisettingsfree-proxiesstats)
- [`POST /api/settings/free-proxies/sync`](references/endpoints.md#post-apisettingsfree-proxiessync)
- [`POST /api/settings/import-json`](references/endpoints.md#post-apisettingsimport-json)
- [`DELETE /api/settings/lkgp-cache`](references/endpoints.md#delete-apisettingslkgp-cache)
- [`GET /api/settings/local-corpus`](references/endpoints.md#get-apisettingslocal-corpus)
- [`POST /api/settings/local-corpus`](references/endpoints.md#post-apisettingslocal-corpus)
- [`DELETE /api/settings/local-corpus`](references/endpoints.md#delete-apisettingslocal-corpus)
- [`GET /api/settings/mitm`](references/endpoints.md#get-apisettingsmitm)
- [`POST /api/settings/mitm`](references/endpoints.md#post-apisettingsmitm)
- [`PUT /api/settings/mitm`](references/endpoints.md#put-apisettingsmitm)
- [`GET /api/settings/model-aliases`](references/endpoints.md#get-apisettingsmodel-aliases)
- [`POST /api/settings/model-aliases`](references/endpoints.md#post-apisettingsmodel-aliases)
- [`PUT /api/settings/model-aliases`](references/endpoints.md#put-apisettingsmodel-aliases)
- [`DELETE /api/settings/model-aliases`](references/endpoints.md#delete-apisettingsmodel-aliases)
- [`GET /api/settings/models-dev`](references/endpoints.md#get-apisettingsmodels-dev)
- [`POST /api/settings/models-dev`](references/endpoints.md#post-apisettingsmodels-dev)
- [`GET /api/settings/notion`](references/endpoints.md#get-apisettingsnotion)
- [`POST /api/settings/notion`](references/endpoints.md#post-apisettingsnotion)
- [`DELETE /api/settings/notion`](references/endpoints.md#delete-apisettingsnotion)
- [`GET /api/settings/obsidian`](references/endpoints.md#get-apisettingsobsidian)
- [`POST /api/settings/obsidian`](references/endpoints.md#post-apisettingsobsidian)
- [`DELETE /api/settings/obsidian`](references/endpoints.md#delete-apisettingsobsidian)
- [`GET /api/settings/obsidian/webdav`](references/endpoints.md#get-apisettingsobsidianwebdav)
- [`POST /api/settings/obsidian/webdav`](references/endpoints.md#post-apisettingsobsidianwebdav)
- [`DELETE /api/settings/obsidian/webdav`](references/endpoints.md#delete-apisettingsobsidianwebdav)
- [`GET /api/settings/oneproxy`](references/endpoints.md#get-apisettingsoneproxy)
- [`POST /api/settings/oneproxy`](references/endpoints.md#post-apisettingsoneproxy)
- [`DELETE /api/settings/oneproxy`](references/endpoints.md#delete-apisettingsoneproxy)
- [`POST /api/settings/oneproxy/rotate`](references/endpoints.md#post-apisettingsoneproxyrotate)
- [`GET /api/settings/proxies`](references/endpoints.md#get-apisettingsproxies)
- [`POST /api/settings/proxies`](references/endpoints.md#post-apisettingsproxies)
- [`PATCH /api/settings/proxies`](references/endpoints.md#patch-apisettingsproxies)
- [`DELETE /api/settings/proxies`](references/endpoints.md#delete-apisettingsproxies)
- [`POST /api/settings/proxies/{id}/repair-relay`](references/endpoints.md#post-apisettingsproxiesidrepair-relay)
- [`GET /api/settings/proxies/assignments`](references/endpoints.md#get-apisettingsproxiesassignments)
- [`PUT /api/settings/proxies/assignments`](references/endpoints.md#put-apisettingsproxiesassignments)
- [`POST /api/settings/proxies/auto-test`](references/endpoints.md#post-apisettingsproxiesauto-test)
- [`POST /api/settings/proxies/batch-activate`](references/endpoints.md#post-apisettingsproxiesbatch-activate)
- [`POST /api/settings/proxies/batch-delete`](references/endpoints.md#post-apisettingsproxiesbatch-delete)
- [`PUT /api/settings/proxies/bulk-assign`](references/endpoints.md#put-apisettingsproxiesbulk-assign)
- [`POST /api/settings/proxies/bulk-import`](references/endpoints.md#post-apisettingsproxiesbulk-import)
- [`GET /api/settings/proxies/egress`](references/endpoints.md#get-apisettingsproxiesegress)
- [`POST /api/settings/proxies/egress`](references/endpoints.md#post-apisettingsproxiesegress)
- [`GET /api/settings/proxies/health`](references/endpoints.md#get-apisettingsproxieshealth)
- [`POST /api/settings/proxies/migrate`](references/endpoints.md#post-apisettingsproxiesmigrate)
- [`GET /api/settings/proxies/pool`](references/endpoints.md#get-apisettingsproxiespool)
- [`PUT /api/settings/proxies/pool`](references/endpoints.md#put-apisettingsproxiespool)
- [`PATCH /api/settings/proxies/pool`](references/endpoints.md#patch-apisettingsproxiespool)
- [`DELETE /api/settings/proxies/pool`](references/endpoints.md#delete-apisettingsproxiespool)
- [`GET /api/settings/proxies/pool/egress-observation`](references/endpoints.md#get-apisettingsproxiespoolegress-observation)
- [`POST /api/settings/proxy/cloudflare-deploy`](references/endpoints.md#post-apisettingsproxycloudflare-deploy)
- [`POST /api/settings/proxy/deno-deploy`](references/endpoints.md#post-apisettingsproxydeno-deploy)
- [`POST /api/settings/proxy/vercel-deploy`](references/endpoints.md#post-apisettingsproxyvercel-deploy)
- [`POST /api/settings/purge-call-logs`](references/endpoints.md#post-apisettingspurge-call-logs)
- [`POST /api/settings/purge-detailed-logs`](references/endpoints.md#post-apisettingspurge-detailed-logs)
- [`POST /api/settings/purge-logs`](references/endpoints.md#post-apisettingspurge-logs)
- [`POST /api/settings/purge-quota-snapshots`](references/endpoints.md#post-apisettingspurge-quota-snapshots)
- [`GET /api/settings/quota/state`](references/endpoints.md#get-apisettingsquotastate)
- [`POST /api/settings/quota/state`](references/endpoints.md#post-apisettingsquotastate)
- [`GET /api/settings/reasoning-routing-rules`](references/endpoints.md#get-apisettingsreasoning-routing-rules)
- [`POST /api/settings/reasoning-routing-rules`](references/endpoints.md#post-apisettingsreasoning-routing-rules)
- [`GET /api/settings/reasoning-routing-rules/{id}`](references/endpoints.md#get-apisettingsreasoning-routing-rulesid)
- [`PATCH /api/settings/reasoning-routing-rules/{id}`](references/endpoints.md#patch-apisettingsreasoning-routing-rulesid)
- [`DELETE /api/settings/reasoning-routing-rules/{id}`](references/endpoints.md#delete-apisettingsreasoning-routing-rulesid)
- [`POST /api/settings/reasoning-routing-rules/simulate`](references/endpoints.md#post-apisettingsreasoning-routing-rulessimulate)
- [`GET /api/settings/task-routing`](references/endpoints.md#get-apisettingstask-routing)
- [`POST /api/settings/task-routing`](references/endpoints.md#post-apisettingstask-routing)
- [`PUT /api/settings/task-routing`](references/endpoints.md#put-apisettingstask-routing)
- [`GET /api/settings/tier-config`](references/endpoints.md#get-apisettingstier-config)
- [`PUT /api/settings/tier-config`](references/endpoints.md#put-apisettingstier-config)
- [`GET /api/settings/transfer/catalog`](references/endpoints.md#get-apisettingstransfercatalog)
- [`POST /api/settings/transfer/export`](references/endpoints.md#post-apisettingstransferexport)
- [`POST /api/settings/transfer/preview`](references/endpoints.md#post-apisettingstransferpreview)
- [`POST /api/settings/transfer/import`](references/endpoints.md#post-apisettingstransferimport)
## Payloads
See the full OpenAPI specification at `GET /api/openapi/spec` or `docs/openapi.yaml` for detailed request/response schemas.
<!-- skill:custom-start -->
<!-- Thinking budget behavior (preserved curated content — #10169) -->
### GET /api/settings/thinking-budget — behavior
Returns proxy-level thinking/reasoning **request rewrite** settings:
| Field | Meaning |
|-------|---------|
| `mode` | `passthrough` (leave client reasoning alone — **required for Codex visible thinking**), `auto` (**strips** all client thinking fields), `custom`, `adaptive` |
| `customBudget` | Fixed budget when `mode=custom` |
| `effortLevel` | Base effort when `mode=adaptive` |
**Not** compression and **not** "decrypt encrypted reasoning". Full guide: `docs/guides/THINKING_BUDGET.md`.
Example — keep client-controlled reasoning (Codex/Desktop):
```bash
curl -X PUT https://localhost:20128/api/settings/thinking-budget \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"mode":"passthrough","customBudget":10240,"effortLevel":"medium"}'
```
Warning: `mode=auto` deletes `reasoning` / `reasoning_effort` / Claude `thinking` from the outbound body before upstream. That can empty thinking panels even when the client requested Ultra + summary.
<!-- skill:custom-end -->
© cheaper-inference · MIT · cheaper-inference/OmniRoute
