--- name: omni-cli-tools description: "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 ```bash curl https://localhost:20128/api/cli-tools/backups \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### POST /api/cli-tools/backups Create CLI tool backup ```bash 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 ```bash 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 ```bash 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 ```bash 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 ```bash 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 ```bash 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 ```bash 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 ```bash 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 ```bash curl https://localhost:20128/api/cli-tools/claude-settings \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### POST /api/cli-tools/claude-settings Apply Claude CLI settings ```bash 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 ```bash 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 ```bash curl https://localhost:20128/api/cli-tools/cline-settings \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### POST /api/cli-tools/cline-settings Apply Cline CLI settings ```bash 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 ```bash 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 ```bash curl https://localhost:20128/api/cli-tools/codex-profiles \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### POST /api/cli-tools/codex-profiles Create Codex profile ```bash 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 ```bash 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 ```bash 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 ```bash curl https://localhost:20128/api/cli-tools/codex-settings \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### POST /api/cli-tools/codex-settings Apply Codex CLI settings ```bash 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 ```bash 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 ```bash curl https://localhost:20128/api/cli-tools/droid-settings \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### POST /api/cli-tools/droid-settings Apply Droid CLI settings ```bash 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 ```bash 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 ```bash curl https://localhost:20128/api/cli-tools/kilo-settings \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### POST /api/cli-tools/kilo-settings Apply Kilo CLI settings ```bash 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 ```bash 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 ```bash curl https://localhost:20128/api/cli-tools/openclaw-settings \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" ``` ### POST /api/cli-tools/openclaw-settings Apply OpenClaw CLI settings ```bash 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 ```bash 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. ```bash 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. ```bash 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. ```bash 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). ```bash 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. ```bash 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. ```bash 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.