omni-cli-tools

Overview

Manage CLI tool integrations exposed via the API. List, configure, and invoke CLI tool plugins that extend OmniRoute's automation surface.

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/cli-tools/backups

List CLI tool backups

curl https://localhost:20128/api/cli-tools/backups \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/backups

Create CLI tool backup

curl -X POST https://localhost:20128/api/cli-tools/backups \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/cli-tools/runtime/{toolId}

Get runtime status for a CLI tool

curl https://localhost:20128/api/cli-tools/runtime/{toolId} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/guide-settings/{toolId}

Get guide settings for a tool

curl https://localhost:20128/api/cli-tools/guide-settings/{toolId} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/antigravity-mitm

Get Antigravity MITM proxy settings

curl https://localhost:20128/api/cli-tools/antigravity-mitm \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/antigravity-mitm

Update Antigravity MITM proxy settings

curl -X POST https://localhost:20128/api/cli-tools/antigravity-mitm \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/antigravity-mitm

Reset Antigravity MITM proxy settings

curl -X DELETE https://localhost:20128/api/cli-tools/antigravity-mitm \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/antigravity-mitm/alias

Get Antigravity MITM alias configuration

curl https://localhost:20128/api/cli-tools/antigravity-mitm/alias \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/cli-tools/antigravity-mitm/alias

Update Antigravity MITM alias configuration

curl -X PUT https://localhost:20128/api/cli-tools/antigravity-mitm/alias \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/cli-tools/claude-settings

Get Claude CLI settings

curl https://localhost:20128/api/cli-tools/claude-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/claude-settings

Apply Claude CLI settings

curl -X POST https://localhost:20128/api/cli-tools/claude-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/claude-settings

Reset Claude CLI settings

curl -X DELETE https://localhost:20128/api/cli-tools/claude-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/cline-settings

Get Cline CLI settings

curl https://localhost:20128/api/cli-tools/cline-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/cline-settings

Apply Cline CLI settings

curl -X POST https://localhost:20128/api/cli-tools/cline-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/cline-settings

Reset Cline CLI settings

curl -X DELETE https://localhost:20128/api/cli-tools/cline-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/codex-profiles

Get Codex profiles

curl https://localhost:20128/api/cli-tools/codex-profiles \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/codex-profiles

Create Codex profile

curl -X POST https://localhost:20128/api/cli-tools/codex-profiles \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

PUT /api/cli-tools/codex-profiles

Update Codex profile

curl -X PUT https://localhost:20128/api/cli-tools/codex-profiles \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/codex-profiles

Delete Codex profile

curl -X DELETE https://localhost:20128/api/cli-tools/codex-profiles \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/codex-settings

Get Codex CLI settings

curl https://localhost:20128/api/cli-tools/codex-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/codex-settings

Apply Codex CLI settings

curl -X POST https://localhost:20128/api/cli-tools/codex-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/codex-settings

Reset Codex CLI settings

curl -X DELETE https://localhost:20128/api/cli-tools/codex-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/droid-settings

Get Droid CLI settings

curl https://localhost:20128/api/cli-tools/droid-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/droid-settings

Apply Droid CLI settings

curl -X POST https://localhost:20128/api/cli-tools/droid-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/droid-settings

Reset Droid CLI settings

curl -X DELETE https://localhost:20128/api/cli-tools/droid-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/kilo-settings

Get Kilo CLI settings

curl https://localhost:20128/api/cli-tools/kilo-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/kilo-settings

Apply Kilo CLI settings

curl -X POST https://localhost:20128/api/cli-tools/kilo-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/kilo-settings

Reset Kilo CLI settings

curl -X DELETE https://localhost:20128/api/cli-tools/kilo-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/openclaw-settings

Get OpenClaw CLI settings

curl https://localhost:20128/api/cli-tools/openclaw-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/openclaw-settings

Apply OpenClaw CLI settings

curl -X POST https://localhost:20128/api/cli-tools/openclaw-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/openclaw-settings

Reset OpenClaw CLI settings

curl -X DELETE https://localhost:20128/api/cli-tools/openclaw-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/crush-settings

Read Crush CLI OmniRoute config

Local-only. Reads the OmniRoute provider block in Crush's config.

curl https://localhost:20128/api/cli-tools/crush-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/crush-settings

Write Crush CLI OmniRoute config

Local-only. Registers OmniRoute as an openai-compat provider in Crush's config.

curl -X POST https://localhost:20128/api/cli-tools/crush-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/crush-settings

Remove OmniRoute from Crush CLI config

Local-only. Removes the OmniRoute provider block from Crush's config.

curl -X DELETE https://localhost:20128/api/cli-tools/crush-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/codewhale-settings

Read CodeWhale CLI OmniRoute config

Local-only. Reads the OmniRoute config block from ~/.codewhale/config.toml (with ~/.deepseek/config.toml legacy fallback).

curl https://localhost:20128/api/cli-tools/codewhale-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/codewhale-settings

Write CodeWhale CLI OmniRoute config

Local-only. Writes the OmniRoute config block in CodeWhale TOML format.

curl -X POST https://localhost:20128/api/cli-tools/codewhale-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/codewhale-settings

Remove OmniRoute from CodeWhale CLI config

Local-only. Removes the OmniRoute config block from CodeWhale's config.

curl -X DELETE https://localhost:20128/api/cli-tools/codewhale-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/all-statuses

GET cli tools › all statuses

curl https://localhost:20128/api/cli-tools/all-statuses \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/apply

POST cli tools › apply

Submit the original toolId, apiKey, optional baseUrl/model and optional dryRun in the JSON body. Returned content is a redacted, non-cacheable preview, not an importable configuration. A non-dry-run request writes the original generated configuration; the container write guard remains active.

curl -X POST https://localhost:20128/api/cli-tools/apply \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"toolId":"claude","apiKey":"<configuration-api-key>","dryRun":true}'

GET /api/cli-tools/config

GET cli tools › config

Returns redacted, non-cacheable previews. Send the configuration API key in x-omniroute-config-api-key, separate from management authentication. API keys in query strings are rejected. Preview content must not be copied into a credential-bearing configuration or submitted as an apply payload.

curl https://localhost:20128/api/cli-tools/config \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "x-omniroute-config-api-key: <configuration-api-key>"

POST /api/cli-tools/config

POST cli tools › config

Submit toolId, apiKey and optional baseUrl/model as JSON. Unknown fields are rejected. Returned content is a redacted, non-cacheable preview, not an importable configuration. To apply, submit the original inputs to POST /api/cli-tools/apply instead of replaying the preview content.

curl -X POST https://localhost:20128/api/cli-tools/config \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"toolId":"claude","apiKey":"<configuration-api-key>"}'

GET /api/cli-tools/deepseek-tui-settings

GET cli tools › deepseek tui settings

curl https://localhost:20128/api/cli-tools/deepseek-tui-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/deepseek-tui-settings

POST cli tools › deepseek tui settings

curl -X POST https://localhost:20128/api/cli-tools/deepseek-tui-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/deepseek-tui-settings

DELETE cli tools › deepseek tui settings

curl -X DELETE https://localhost:20128/api/cli-tools/deepseek-tui-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/detect

GET cli tools › detect

curl https://localhost:20128/api/cli-tools/detect \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/forge-settings

GET cli tools › forge settings

curl https://localhost:20128/api/cli-tools/forge-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/forge-settings

POST cli tools › forge settings

curl -X POST https://localhost:20128/api/cli-tools/forge-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/forge-settings

DELETE cli tools › forge settings

curl -X DELETE https://localhost:20128/api/cli-tools/forge-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/grok-build-settings

GET cli tools › grok build settings

curl https://localhost:20128/api/cli-tools/grok-build-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/grok-build-settings

POST cli tools › grok build settings

curl -X POST https://localhost:20128/api/cli-tools/grok-build-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/grok-build-settings

DELETE cli tools › grok build settings

curl -X DELETE https://localhost:20128/api/cli-tools/grok-build-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/hermes-agent-settings

GET cli tools › hermes agent settings

curl https://localhost:20128/api/cli-tools/hermes-agent-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/hermes-agent-settings

POST cli tools › hermes agent settings

curl -X POST https://localhost:20128/api/cli-tools/hermes-agent-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/cli-tools/jcode-settings

GET cli tools › jcode settings

curl https://localhost:20128/api/cli-tools/jcode-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/jcode-settings

POST cli tools › jcode settings

curl -X POST https://localhost:20128/api/cli-tools/jcode-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/jcode-settings

DELETE cli tools › jcode settings

curl -X DELETE https://localhost:20128/api/cli-tools/jcode-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/keys

GET cli tools › keys

curl https://localhost:20128/api/cli-tools/keys \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/letta-settings

GET cli tools › letta settings

curl https://localhost:20128/api/cli-tools/letta-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/letta-settings

POST cli tools › letta settings

curl -X POST https://localhost:20128/api/cli-tools/letta-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/letta-settings

DELETE cli tools › letta settings

curl -X DELETE https://localhost:20128/api/cli-tools/letta-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/logs

GET cli tools › logs

curl https://localhost:20128/api/cli-tools/logs \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/omp-settings

GET cli tools › omp settings

curl https://localhost:20128/api/cli-tools/omp-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/omp-settings

POST cli tools › omp settings

curl -X POST https://localhost:20128/api/cli-tools/omp-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/omp-settings

DELETE cli tools › omp settings

curl -X DELETE https://localhost:20128/api/cli-tools/omp-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/openclaw/auto-order

GET cli tools › openclaw › auto order

curl https://localhost:20128/api/cli-tools/openclaw/auto-order \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/pi-settings

GET cli tools › pi settings

curl https://localhost:20128/api/cli-tools/pi-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/pi-settings

POST cli tools › pi settings

curl -X POST https://localhost:20128/api/cli-tools/pi-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/pi-settings

DELETE cli tools › pi settings

curl -X DELETE https://localhost:20128/api/cli-tools/pi-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/qwen-settings

GET cli tools › qwen settings

curl https://localhost:20128/api/cli-tools/qwen-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/qwen-settings

POST cli tools › qwen settings

curl -X POST https://localhost:20128/api/cli-tools/qwen-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/qwen-settings

DELETE cli tools › qwen settings

curl -X DELETE https://localhost:20128/api/cli-tools/qwen-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/smelt-settings

GET cli tools › smelt settings

curl https://localhost:20128/api/cli-tools/smelt-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/cli-tools/smelt-settings

POST cli tools › smelt settings

curl -X POST https://localhost:20128/api/cli-tools/smelt-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/cli-tools/smelt-settings

DELETE cli tools › smelt settings

curl -X DELETE https://localhost:20128/api/cli-tools/smelt-settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/cli-tools/status

GET cli tools › status

curl https://localhost:20128/api/cli-tools/status \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

Payloads

See the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.