omni-settings
Read and update global application settings: system prompts, thinking budget, IP filters, payload rules, combo defaults, and require-login configuration.
How do I install this agent skill?
npx skills add https://github.com/cheaper-inference/omniroute --skill omni-settingsIs this agent skill safe to install?
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Gen Agent Trust Hubpass
This skill provides documentation and endpoint references for managing the global settings of an application (Omni). It allows an agent to read and update various configurations, including security policies, system prompts, and third-party integrations (e.g., Qdrant, Notion, Obsidian). The skill operates on a local service and includes documentation for secure handling of sensitive data, such as masking API keys and requiring passwords for security-sensitive updates. No malicious patterns were detected.
What does this agent skill do?
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/memoryPUT /api/settings/memoryGET /api/settings/qdrantPUT /api/settings/qdrantGET /api/settings/qdrant/healthPOST /api/settings/qdrant/searchPOST /api/settings/qdrant/cleanupGET /api/settings/qdrant/embedding-modelsGET /api/settingsPATCH /api/settingsPOST /api/settings/purge-request-historyGET /api/settings/compressionPUT /api/settings/compressionGET /api/settings/compression/mcp-accessibilityPUT /api/settings/compression/mcp-accessibilityGET /api/settings/payload-rulesPUT /api/settings/payload-rulesGET /api/settings/combo-defaultsGET /api/settings/proxyPATCH /api/settings/proxyPOST /api/settings/proxy/testPOST /api/settings/require-loginGET /api/settings/ip-filterPUT /api/settings/ip-filterGET /api/settings/piiPUT /api/settings/piiPOST /api/settings/pii/testGET /api/settings/system-promptPUT /api/settings/system-promptGET /api/settings/thinking-budgetPUT /api/settings/thinking-budgetGET /api/tagsGET /api/settings/quota-storePUT /api/settings/quota-storePOST /api/settings/purge-usage-historyGET /api/settings/authz-inventoryGET /api/settings/auto-disable-accountsPUT /api/settings/auto-disable-accountsGET /api/settings/background-degradationPOST /api/settings/background-degradationPUT /api/settings/background-degradationGET /api/settings/cache-configPUT /api/settings/cache-configGET /api/settings/cache-metricsDELETE /api/settings/cache-metricsGET /api/settings/cc-discovery-metricsGET /api/settings/compression/rulesGET /api/settings/compression/run-telemetryGET /api/settings/databasePUT /api/settings/databasePATCH /api/settings/databasePOST /api/settings/database/integrity-checkPOST /api/settings/database/refresh-statsGET /api/settings/database/vacuumPOST /api/settings/database/vacuumGET /api/settings/export-jsonGET /api/settings/faviconGET /api/settings/feature-flagsPUT /api/settings/feature-flagsDELETE /api/settings/feature-flagsGET /api/settings/free-proxiesDELETE /api/settings/free-proxiesPOST /api/settings/free-proxies/{id}/add-to-poolPOST /api/settings/free-proxies/bulk-add-to-poolGET /api/settings/free-proxies/statsPOST /api/settings/free-proxies/syncPOST /api/settings/import-jsonDELETE /api/settings/lkgp-cacheGET /api/settings/local-corpusPOST /api/settings/local-corpusDELETE /api/settings/local-corpusGET /api/settings/mitmPOST /api/settings/mitmPUT /api/settings/mitmGET /api/settings/model-aliasesPOST /api/settings/model-aliasesPUT /api/settings/model-aliasesDELETE /api/settings/model-aliasesGET /api/settings/models-devPOST /api/settings/models-devGET /api/settings/notionPOST /api/settings/notionDELETE /api/settings/notionGET /api/settings/obsidianPOST /api/settings/obsidianDELETE /api/settings/obsidianGET /api/settings/obsidian/webdavPOST /api/settings/obsidian/webdavDELETE /api/settings/obsidian/webdavGET /api/settings/oneproxyPOST /api/settings/oneproxyDELETE /api/settings/oneproxyPOST /api/settings/oneproxy/rotateGET /api/settings/proxiesPOST /api/settings/proxiesPATCH /api/settings/proxiesDELETE /api/settings/proxiesPOST /api/settings/proxies/{id}/repair-relayGET /api/settings/proxies/assignmentsPUT /api/settings/proxies/assignmentsPOST /api/settings/proxies/auto-testPOST /api/settings/proxies/batch-activatePOST /api/settings/proxies/batch-deletePUT /api/settings/proxies/bulk-assignPOST /api/settings/proxies/bulk-importGET /api/settings/proxies/egressPOST /api/settings/proxies/egressGET /api/settings/proxies/healthPOST /api/settings/proxies/migrateGET /api/settings/proxies/poolPUT /api/settings/proxies/poolPATCH /api/settings/proxies/poolDELETE /api/settings/proxies/poolGET /api/settings/proxies/pool/egress-observationPOST /api/settings/proxy/cloudflare-deployPOST /api/settings/proxy/deno-deployPOST /api/settings/proxy/vercel-deployPOST /api/settings/purge-call-logsPOST /api/settings/purge-detailed-logsPOST /api/settings/purge-logsPOST /api/settings/purge-quota-snapshotsGET /api/settings/quota/statePOST /api/settings/quota/stateGET /api/settings/reasoning-routing-rulesPOST /api/settings/reasoning-routing-rulesGET /api/settings/reasoning-routing-rules/{id}PATCH /api/settings/reasoning-routing-rules/{id}DELETE /api/settings/reasoning-routing-rules/{id}POST /api/settings/reasoning-routing-rules/simulateGET /api/settings/task-routingPOST /api/settings/task-routingPUT /api/settings/task-routingGET /api/settings/tier-configPUT /api/settings/tier-configGET /api/settings/transfer/catalogPOST /api/settings/transfer/exportPOST /api/settings/transfer/previewPOST /api/settings/transfer/import
Payloads
See the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.
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):
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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/cheaper-inference/omniroute/omni-settings">View omni-settings on skillZs</a>