omni-cli-tools

---
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."
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## 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"
```

### GET /api/cli-tools/all-statuses

GET cli tools › all statuses

```bash
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.

```bash
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.

```bash
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.

```bash
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

```bash
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

```bash
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

```bash
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

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

### GET /api/cli-tools/forge-settings

GET cli tools › forge settings

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

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

### GET /api/cli-tools/letta-settings

GET cli tools › letta settings

```bash
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

```bash
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

```bash
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

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

### GET /api/cli-tools/omp-settings

GET cli tools › omp settings

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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.