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"

Payloads

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