Files
2026-07-13 13:39:12 +08:00

9.0 KiB

name, description
name description
omni-cli-tools Manage CLI tool integrations exposed via the API. List, configure, and invoke CLI tool plugins that extend OmniRoute's automation surface.

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.