# CLI Tools — OmniRoute (Latviešu)

🌐 **Languages:** 🇺🇸 [English](../../../../reference/CLI-TOOLS.md) · 🇪🇹 [am](../../../am/docs/reference/CLI-TOOLS.md) · 🇸🇦 [ar](../../../ar/docs/reference/CLI-TOOLS.md) · 🇦🇿 [az](../../../az/docs/reference/CLI-TOOLS.md) · 🇧🇬 [bg](../../../bg/docs/reference/CLI-TOOLS.md) · 🇧🇩 [bn](../../../bn/docs/reference/CLI-TOOLS.md) · 🇧🇦 [bs](../../../bs/docs/reference/CLI-TOOLS.md) · 🇨🇿 [cs](../../../cs/docs/reference/CLI-TOOLS.md) · 🇩🇰 [da](../../../da/docs/reference/CLI-TOOLS.md) · 🇩🇪 [de](../../../de/docs/reference/CLI-TOOLS.md) · 🇬🇷 [el](../../../el/docs/reference/CLI-TOOLS.md) · 🇪🇸 [es](../../../es/docs/reference/CLI-TOOLS.md) · 🇪🇪 [et](../../../et/docs/reference/CLI-TOOLS.md) · 🇮🇷 [fa](../../../fa/docs/reference/CLI-TOOLS.md) · 🇫🇮 [fi](../../../fi/docs/reference/CLI-TOOLS.md) · 🇫🇷 [fr](../../../fr/docs/reference/CLI-TOOLS.md) · 🇮🇪 [ga](../../../ga/docs/reference/CLI-TOOLS.md) · 🇮🇳 [gu](../../../gu/docs/reference/CLI-TOOLS.md) · 🇳🇬 [ha](../../../ha/docs/reference/CLI-TOOLS.md) · 🇮🇱 [he](../../../he/docs/reference/CLI-TOOLS.md) · 🇮🇳 [hi](../../../hi/docs/reference/CLI-TOOLS.md) · 🇭🇷 [hr](../../../hr/docs/reference/CLI-TOOLS.md) · 🇭🇺 [hu](../../../hu/docs/reference/CLI-TOOLS.md) · 🇦🇲 [hy](../../../hy/docs/reference/CLI-TOOLS.md) · 🇮🇩 [id](../../../id/docs/reference/CLI-TOOLS.md) · 🇳🇬 [ig](../../../ig/docs/reference/CLI-TOOLS.md) · 🇮🇹 [it](../../../it/docs/reference/CLI-TOOLS.md) · 🇯🇵 [ja](../../../ja/docs/reference/CLI-TOOLS.md) · 🇬🇪 [ka](../../../ka/docs/reference/CLI-TOOLS.md) · 🇰🇭 [km](../../../km/docs/reference/CLI-TOOLS.md) · 🇮🇳 [kn](../../../kn/docs/reference/CLI-TOOLS.md) · 🇰🇷 [ko](../../../ko/docs/reference/CLI-TOOLS.md) · 🇱🇹 [lt](../../../lt/docs/reference/CLI-TOOLS.md) · 🇮🇳 [ml](../../../ml/docs/reference/CLI-TOOLS.md) · 🇮🇳 [mr](../../../mr/docs/reference/CLI-TOOLS.md) · 🇲🇾 [ms](../../../ms/docs/reference/CLI-TOOLS.md) · 🇲🇹 [mt](../../../mt/docs/reference/CLI-TOOLS.md) · 🇲🇲 [my](../../../my/docs/reference/CLI-TOOLS.md) · 🇳🇵 [ne](../../../ne/docs/reference/CLI-TOOLS.md) · 🇳🇱 [nl](../../../nl/docs/reference/CLI-TOOLS.md) · 🇳🇴 [no](../../../no/docs/reference/CLI-TOOLS.md) · 🇮🇳 [or](../../../or/docs/reference/CLI-TOOLS.md) · 🇮🇳 [pa](../../../pa/docs/reference/CLI-TOOLS.md) · 🇵🇭 [phi](../../../phi/docs/reference/CLI-TOOLS.md) · 🇵🇱 [pl](../../../pl/docs/reference/CLI-TOOLS.md) · 🇵🇹 [pt](../../../pt/docs/reference/CLI-TOOLS.md) · 🇧🇷 [pt-BR](../../../pt-BR/docs/reference/CLI-TOOLS.md) · 🇷🇴 [ro](../../../ro/docs/reference/CLI-TOOLS.md) · 🇷🇺 [ru](../../../ru/docs/reference/CLI-TOOLS.md) · 🇱🇰 [si](../../../si/docs/reference/CLI-TOOLS.md) · 🇸🇰 [sk](../../../sk/docs/reference/CLI-TOOLS.md) · 🇸🇮 [sl](../../../sl/docs/reference/CLI-TOOLS.md) · 🇷🇸 [sr](../../../sr/docs/reference/CLI-TOOLS.md) · 🇸🇪 [sv](../../../sv/docs/reference/CLI-TOOLS.md) · 🇰🇪 [sw](../../../sw/docs/reference/CLI-TOOLS.md) · 🇮🇳 [ta](../../../ta/docs/reference/CLI-TOOLS.md) · 🇮🇳 [te](../../../te/docs/reference/CLI-TOOLS.md) · 🇹🇭 [th](../../../th/docs/reference/CLI-TOOLS.md) · 🇹🇷 [tr](../../../tr/docs/reference/CLI-TOOLS.md) · 🇺🇦 [uk-UA](../../../uk-UA/docs/reference/CLI-TOOLS.md) · 🇵🇰 [ur](../../../ur/docs/reference/CLI-TOOLS.md) · 🇺🇿 [uz](../../../uz/docs/reference/CLI-TOOLS.md) · 🇻🇳 [vi](../../../vi/docs/reference/CLI-TOOLS.md) · 🇳🇬 [yo](../../../yo/docs/reference/CLI-TOOLS.md) · 🇨🇳 [zh-CN](../../../zh-CN/docs/reference/CLI-TOOLS.md) · 🇹🇼 [zh-TW](../../../zh-TW/docs/reference/CLI-TOOLS.md)

---

Pēdējoreiz atjaunināts: 2026-08-23

OmniRoute integrējas ar trīs kategoriju CLI rīkiem, kas sadalīti trīs īpašās informācijas paneļa lapās:

| Lapa           | Maršruts                | Koncepcija                                                                                      | Skaits           |
| -------------- | ----------------------- | ----------------------------------------------------------------------------------------------- | ---------------- |
| **CLI kodi**   | `/dashboard/cli-code`   | Kodēšanas rīki, kurus novirzāt uz OmniRoute (Klients → CLI → OmniRoute → Pakalpojuma sniedzējs) | 26               |
| **CLI aģenti** | `/dashboard/cli-agents` | Autonomi aģenti, kurus novirzāt uz OmniRoute (tā pati plūsma, plašāks tvērums)                  | 10               |
| **ACP aģenti** | `/dashboard/acp-agents` | CLI, kurus OmniRoute palaiž kā aizmugursistēmas, izmantojot stdio/ACP (apgrieztā plūsma)        | skatiet reģistru |

Novecojušie maršruti veic 308 novirzīšanu: `/dashboard/cli-tools` → `/dashboard/cli-code`, `/dashboard/agents` → `/dashboard/acp-agents`.

---

## Kā tas darbojas

```
CLI kodi / CLI aģenti (patēriņa plūsma):
Claude / Codex / OpenCode / Cline / KiloCode / Continue / Hermes Agent / Goose / ...
           │
           ▼  (visi tiek novirzīti uz OmniRoute)
    http://YOUR_SERVER:20128/v1
           │
           ▼  (OmniRoute novirza uz atbilstošo pakalpojuma sniedzēju)
    Anthropic / OpenAI / Gemini / DeepSeek / Groq / Mistral / ...

ACP aģenti (apgrieztā palaišanas plūsma):
    Klienta pieprasījums → OmniRoute → palaiž CLI, izmantojot stdio/ACP → atbilde
```

**Priekšrocības:**

- Viena API atslēga visu rīku pārvaldībai
- Izmaksu uzskaite visiem CLI informācijas panelī
- Modeļu pārslēgšana bez katra rīka atkārtotas konfigurēšanas
- Darbojas lokāli un attālos serveros (VPS, Docker, Akamai, Cloudflare Tunnel)

---

## Automātiska konfigurēšana ar `setup-*`

Katra rīka konfigurācija nav jāraksta manuāli. OmniRoute nodrošina `setup-*`
komandu katram atbalstītajam CLI, kura nolasa **aktuālo** modeļu katalogu no
darbojošās OmniRoute instances (lokālas vai attālas) un ieraksta attiecīgā rīka
konfigurāciju jūsu datorā:

```bash
omniroute setup-codex        omniroute setup-claude       omniroute setup-opencode
omniroute setup-cline        omniroute setup-kilo         omniroute setup-continue
omniroute setup-cursor       omniroute setup-roo          omniroute setup-crush
omniroute setup-goose        omniroute setup-qwen         omniroute setup-aider
omniroute setup-5dive
```

Katra komanda pieņem `--remote <url> --api-key <key>` (lokāla rīka konfigurēšanai
darbam ar attālu OmniRoute), `--dry-run` (priekšskatījumam bez ierakstīšanas) un
`--port`. Rīkiem bez automātiskas modeļa noteikšanas (Cline, Kilo, Roo, Goose,
Aider, Qwen, 5dive) jānorāda `--model <id>` (un `--yes` neinteraktīvai izpildei).
`setup-5dive` ir vienīgā recepte, kas neveic ierakstīšanu zem `$HOME`: tā
konfigurē 5dive aģentu kopu, kopas resursdatorā ierakstot root piederošu
autentifikācijas profilu, tādēļ tā atkārtoti izpilda sevi ar `sudo` un tai nav
sava attālā režīma. Lai palaistu CLI ar ievadītiem pareizajiem vides mainīgajiem,
vispār neierakstot konfigurāciju, izmantojiet vispārīgo
`omniroute run <target>` palaidēju (claude, codex, aider, goose, opencode, qwen,
gemini — mērķi un aizstājvārdi tiek iegūti no `bin/cli/cli-manifest.mjs`);
joprojām ir pieejami novecojušie katram rīkam paredzētie palaidēji
`omniroute launch` (Claude Code) un `omniroute launch-codex` (Codex). Gemini CLI
ir paredzēts tikai palaišanai: tas ir `omniroute run` mērķis, taču tam nav
`setup-*`/`configure` receptes.

> **Pilna atsauce:** galvenā tabula — ko katra komanda ieraksta, visi karodziņi,
> lokāla un attāla izmantošana, kā arī tas, kuriem rīkiem nepieciešams `/v1`
> sufikss — ir pieejama sadaļā
> **[CLI integrācijas](../guides/CLI-INTEGRATIONS.md)**.

### To izpilde konteinerā

Konteinerā OmniRoute izpildīta `setup-*` komanda raksta paša konteinera mājas
direktorijā, kuru neviens resursdatora CLI nelasa un kura pazūd kopā ar
konteineru. OmniRoute to nosaka un tā vietā, lai veiktu ierakstīšanu, beidz darbu
ar kodu `2` un parāda norādījumus. Ir divi atbalstīti risinājumi — instalējiet
CLI resursdatorā un izmantojiet `omniroute connect`, lai savienotos ar
konteineru, vai piesaistiet konfigurācijas direktorijus un iestatiet
`CLI_CONFIG_HOME` (compose profils `host`). Katra `setup-*` komanda, kā arī
`omniroute configure` un `omniroute config set`, pieņem
`--allow-container-write`, ja patiesībā vēlaties konfigurēt paša konteinera CLI;
`OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE=true` nodrošina to pašu serverim. Skatiet
[Docker rokasgrāmata → Resursdatora CLI rīku konfigurēšana](../guides/DOCKER_GUIDE.md#configuring-host-cli-tools-when-omniroute-runs-in-docker).

Informācijas paneļa **lietošanas galapunkts** (`POST /api/cli-tools/apply`) piemēro
to pašu aizsardzību: konteinerā ierakstīšanas pieprasījums, kura mērķis nav
piesaistīts no resursdatora, atbild ar **`422`**, `containerEphemeralTarget: true`,
drošu kļūdas tekstu un — rīkiem, kuriem ir resursdatora recepte (claude, codex,
opencode, cline, kilo, continue) — `hostSetupCommand` (piem.,
`omniroute setup-opencode`), kas tā vietā jāizpilda resursdatorā; nekas netiek
ierakstīts. `dryRun: true` turpina darboties konteinera režīmā un, nepiekļūstot
diskam, atgriež aizklātu priekšskatījumu un mērķa ceļu. Priekšskatījuma saturs
nav akreditācijas datus saturoša konfigurācija, ko kopēt vai importēt.
Resursdatorā lietojiet sākotnējos rīka, pamata URL, API atslēgas un modeļa ievades
datus vai izmantojiet norādīto resursdatora puses iestatīšanas komandu. Informāciju
par priekšskatījuma galveni un pieprasījuma līgumu skatiet sadaļā
[CLI konfigurācijas drošība](../security/CLI-CONFIGURATION.md). Šāda darbība ir
apzināta, un pret regresijām to aizsargā
`tests/unit/api/cli-tools/apply-container-guard.test.ts` — nekad „nelabojiet” 422
kļūdu, noņemot šo aizsardzību.

---

## Patiesais avots

Vienotais katalogs atrodas failā `src/shared/constants/cliTools.ts` kā `CLI_TOOLS: Record<string, CliCatalogEntry>`.

Katram ierakstam ir šādi lauki (definēti failā `src/shared/schemas/cliCatalog.ts`):

| Lauks                                           | Tips                                                         | Apraksts                                                                          |
| ----------------------------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------- |
| `category`                                      | `"code" \| "agent"`                                          | Lapa, kurā rīks tiek attēlots                                                     |
| `vendor`                                        | `string`                                                     | Rīka izcelsme ("Anthropic", "OSS (P. Gauthier)")                                  |
| `acpSpawnable`                                  | `boolean`                                                    | Var izmantot arī kā ACP aģentu (tiek rādīta emblēma)                              |
| `baseUrlSupport`                                | `"full" \| "partial" \| "none"`                              | Pielāgota galapunkta atbalsta līmenis. `"none"` = MITM neizpildīto darbu saraksts |
| `configType`                                    | `"env" \| "custom" \| "guide" \| "custom-builder" \| "mitm"` | Konfigurācijas mehānisms                                                          |
| `id`, `name`, `color`, `description`, `docsUrl` | standarta                                                    | Galvenie attēlošanas lauki                                                        |

Ieraksti ar `baseUrlSupport: "none"` informācijas paneļa lapās **netiek rādīti** — tie ir reģistrēti 11. plāna MITM neizpildīto darbu sarakstā (skatiet `_tasks/features-v3.8.6/refactorpages/_orchestration/_plan11-mitm-backlog.md`).

### Iespēju līmeņi (katalogizēts × nosakāms × konfigurējams × palaižams)

Ne katrs katalogizētais rīks ir nosakāms, konfigurējams vai palaižams. Katram līmenim ir viens
deklarācijas avots, un noviržu tests nodrošina to savstarpēju atbilstību:

| Līmenis           | Nozīme                                                                                            | Deklarēts                                                              |
| ----------------- | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| **Katalogizēts**  | Parādās informācijas paneļa katalogā (nosaukums, piegādātājs, dokumentācija, konfigurācijas tips) | `src/shared/constants/cliTools.ts` (`CLI_TOOLS`)                       |
| **Nosakāms**      | Binārā faila/konfigurācijas noteikšana, darbspējas pārbaudes, konfigurācijas ceļi                 | `src/shared/services/cliRuntime.ts` (`CLI_TOOLS` izpildlaika katalogs) |
| **Konfigurējams** | Atbalsta `omniroute configure <cli>` (pastāv iestatīšanas recepte)                                | `bin/cli/cli-manifest.mjs` (`configure: true`)                         |
| **Palaižams**     | Atbalsta `omniroute run <target>` (definēta vides/argumentu ievietošana)                          | `bin/cli/cli-manifest.mjs` (`run: true`)                               |

`bin/cli/cli-manifest.mjs` ir kanoniskais izpildāmais manifests CLI komandu
saskarnēm: `run`, `configure` un čaulas automātiskās pabeigšanas ģeneratori no tā iegūst
mērķu sarakstus, aizstājvārdu atrisināšanu (piemēram, `kilocode`/`kilo-code`/`kilo_cli` → `kilo`)
un karoga `--model` piesaisti. Noviržu aizsargs
`tests/unit/cli/cli-manifest-drift.test.ts` pārbauda, ka manifests, izpildlaika
katalogs, lietotāja saskarnes katalogs un visas patērētāju saskarnes ir sinhronizētas — ja mērķis tiek pievienots
vienai saskarnei, bet ne pārējām, testu komplekts neizdodas, nevis ļauj neatbilstībai palikt nepamanītai.

---

## 1. CLI Code katalogs (26 rīki)

Visi rīki, kas tiek rādīti sadaļā `/dashboard/cli-code`. Rīki ar `baseUrlSupport: none` tiek savienoti, izmantojot MITM vai manuālu ceļvedi, nevis pielāgotu bāzes URL:

| id           | name                    | vendor              | baseUrlSupport | configType     | acpSpawnable |
| ------------ | ----------------------- | ------------------- | -------------- | -------------- | ------------ |
| claude       | Claude Code             | Anthropic           | full           | env            | true         |
| codex        | OpenAI Codex CLI        | OpenAI              | full           | custom         | true         |
| zcode        | ZCode (GLM Coding Plan) | Z.ai                | none           | custom         | false        |
| cline        | Cline                   | OSS (ex-Claude Dev) | full           | custom         | true         |
| kilo         | Kilo Code               | Kilo-Org            | full           | custom         | false        |
| roo          | Roo Code                | Roo (OSS)           | full           | guide          | false        |
| continue     | Continue                | continue.dev        | full           | guide          | false        |
| aider        | Aider                   | OSS (P. Gauthier)   | full           | guide          | true         |
| forge        | ForgeCode               | Antinomy HQ         | full           | custom         | true         |
| jcode        | jcode                   | 1jehuang (OSS)      | full           | custom         | false        |
| deepseek-tui | DeepSeek TUI            | Hunter Bown (OSS)   | full           | custom         | false        |
| codewhale    | CodeWhale               | Hmbown (OSS)        | full           | custom         | false        |
| opencode     | OpenCode                | Anomaly (ex-SST)    | full           | guide          | true         |
| droid        | Factory Droid           | Factory AI          | partial        | guide          | false        |
| copilot      | GitHub Copilot CLI      | GitHub/MS           | full           | custom         | false        |
| cursor-cli   | Cursor CLI              | Anysphere           | partial        | guide          | true         |
| smelt        | Smelt                   | leonardcser (OSS)   | full           | custom         | false        |
| pi           | Pi (pi-coding-agent)    | M. Zechner (OSS)    | full           | custom         | false        |
| grok-build   | Grok Build              | xAI                 | full           | custom         | false        |
| crush        | Crush                   | OSS (Charm)         | full           | custom         | false        |
| qwen         | Qwen Code               | Alibaba             | full           | guide          | true         |
| cursor       | Cursor                  | Anysphere           | none           | guide          | false        |
| antigravity  | Antigravity             | Google              | none           | mitm           | false        |
| hermes       | Hermes                  | Nous Research       | none           | guide          | false        |
| kiro         | Kiro AI                 | Amazon              | none           | mitm           | false        |
| custom       | Custom CLI              | —                   | full           | custom-builder | false        |

Rīkiem ar `baseUrlSupport: "partial"` informācijas paneļa kartītē tiek rādīta emblēma "⚠ Daļējs bāzes URL".
---

## 2. CLI aģentu katalogs (10 rīki)

Autonomie aģenti, kas tiek rādīti lapā `/dashboard/cli-agents`:

| id           | name             | vendor                   | baseUrlSupport | acpSpawnable |
| ------------ | ---------------- | ------------------------ | -------------- | ------------ |
| hermes-agent | Hermes Agent     | Nous Research            | full           | false        |
| openclaw     | OpenClaw         | OSS (P. Steinberger)     | full           | true         |
| goose        | Goose            | Block / Linux Foundation | full           | true         |
| interpreter  | Open Interpreter | OSS                      | full           | true         |
| warp         | Warp AI          | Warp Inc.                | partial        | true         |
| agent-deck   | Agent Deck       | asheshgoplani (OSS)      | full           | false        |
| omp          | Oh My Pi         | OSS                      | full           | true         |
| letta        | Letta CLI        | Letta                    | full           | false        |
| prime-agent  | Prime Agent      | Prime Intellect (OSS)    | full           | false        |
| 5dive        | 5dive            | OSS (5dive-ai)           | full           | false        |

---

## 3. ACP aģenti (/dashboard/acp-agents)

Šajā lapā (pārdēvēta no `/dashboard/agents`) tiek rādīti CLI, kurus OmniRoute var **palaist** kā aizmugursistēmas izpildes dzinējus, izmantojot stdio/ACP protokolu. Katalogs tiek uzturēts atsevišķi failā `src/lib/acp/registry.ts`, un tas **nav** tas pats, kas `CLI_TOOLS`.

---

## 4. MITM neizpildīto darbu saraksts (informācijas panelī netiek rādīts)

Tālāk norādītie CLI sākotnēji neatbalsta pielāgotu pamata URL un **nav uzskaitīti** CLI Code vai CLI Agents lapās. Tie ir MITM pārtveršanas kandidāti 11. plānā:

| CLI                 | Iemesls                                                                    |
| ------------------- | -------------------------------------------------------------------------- |
| windsurf            | BYOK ir ierobežots līdz noteiktiem Claude modeļiem un uzņēmuma URL/tokenam |
| amp                 | Slēgta ekosistēma (Sourcegraph)                                            |
| amazon-q / kiro-cli | AWS SSO autentifikācija, nav pielāgota URL                                 |
| cowork              | Anthropic Desktop, nav konfigurējama galapunkta                            |

Pilnu savstarpējo atsauču sarakstu skatiet failā `_tasks/features-v3.8.6/refactorpages/_orchestration/_plan11-mitm-backlog.md`.

---

## 5. Pakešveida noteikšanas API

Visa rīku noteikšana tiek apkopota, izmantojot vienu galapunktu:

**`GET /api/cli-tools/all-statuses`**

- Autentifikācija: `requireCliToolsAuth(request)` (tāda pati kā citiem `/api/cli-tools/` maršrutiem)
- Atgriež: `Record<toolId, ToolBatchStatus>` (tips: `src/shared/types/cliBatchStatus.ts`)
- Stratēģija: `Promise.all` visiem rīkiem, 5 s taimauts katram rīkam
- Kešatmiņa: atmiņā glabāta LRU kešatmiņa, kas indeksēta pēc konfigurācijas faila `mtime`. Kešatmiņa tiek padarīta nederīga, kad mainās mtime. Tā tiek atiestatīta pēc servera restartēšanas.

Atbildes struktūra katram rīkam:

```ts
interface ToolBatchStatus {
  detection: {
    installed: boolean;
    runnable: boolean;
    version?: string;
    command?: string;
    commandPath?: string;
    reason?: string;
  };
  config: {
    status: "configured" | "not_configured" | "not_installed" | "unknown" | "other";
    endpoint?: string | null;
    lastConfiguredAt?: string | null;
  };
  error?: string; // attīrīts, bez steka trasējumiem
}
```

---

## 6. Iestatījumu apstrādātāji jaunajiem rīkiem

Jaunajiem rīkiem ar `configType: "custom"` ir īpaši iestatījumu API maršruti:

| Maršruts                                    | Rīks                                                                          |
| ------------------------------------------- | ----------------------------------------------------------------------------- |
| `POST /api/cli-tools/forge-settings`        | ForgeCode (.forge.toml)                                                       |
| `POST /api/cli-tools/jcode-settings`        | jcode (--base-url karodziņš)                                                  |
| `POST /api/cli-tools/deepseek-tui-settings` | DeepSeek TUI (OPENAI_BASE_URL, mantotais)                                     |
| `POST /api/cli-tools/codewhale-settings`    | CodeWhale (OPENAI_BASE_URL, primārais + mantotā `~/.deepseek` sinhronizācija) |
| `POST /api/cli-tools/smelt-settings`        | Smelt                                                                         |
| `POST /api/cli-tools/pi-settings`           | Pi programmēšanas aģents                                                      |
| `POST /api/cli-tools/grok-build-settings`   | Grok Build (~/.grok/config.toml, `[model.omniroute]`)                         |
| `POST /api/cli-tools/qwen-settings`         | Qwen Code (`~/.qwen/settings.json` + īpaša `.env` atslēga)                    |

Visi maršruti kļūdu atbildēm izmanto `sanitizeErrorMessage()` (stingrais noteikums Nr. 12).

---

## 7. Informācijas paneļa lapu arhitektūra

### CLI kodi (`/dashboard/cli-code`)

- `src/app/(dashboard)/dashboard/cli-code/page.tsx` — servera komponents
- `src/app/(dashboard)/dashboard/cli-code/CliCodePageClient.tsx` — klienta režģis
- `src/app/(dashboard)/dashboard/cli-code/[id]/page.tsx` — rīka detalizētās informācijas lapa
- `src/app/(dashboard)/dashboard/cli-code/components/` — 12 specializētas rīku kartītes + `ToolDetailClient.tsx`

### CLI aģenti (`/dashboard/cli-agents`)

- `src/app/(dashboard)/dashboard/cli-agents/page.tsx` — servera komponents
- `src/app/(dashboard)/dashboard/cli-agents/CliAgentsPageClient.tsx` — klienta režģis
- `src/app/(dashboard)/dashboard/cli-agents/[id]/page.tsx` — atkārtoti izmanto `ToolDetailClient`

### ACP aģenti (`/dashboard/acp-agents`)

- `src/app/(dashboard)/dashboard/acp-agents/page.tsx` — servera komponents (pārvietots no `agents/`)

### Koplietojamie lietotāja saskarnes komponenti (`src/shared/components/cli/`)

| Fails                   | Nolūks                                                          |
| ----------------------- | --------------------------------------------------------------- |
| `CliToolCard.tsx`       | Viedā statusa kartīte (noteikšana + konfigurācija + galapunkts) |
| `CliConceptCard.tsx`    | Katras lapas koncepcijas skaidrojuma kartīte                    |
| `CliComparisonCard.tsx` | Trīs kolonnu salīdzinājums starp CLI tipiem                     |
| `BaseUrlSelect.tsx`     | Galapunkta nolaižamā izvēlne (lokāls/mākonis/pielāgots)         |
| `ApiKeySelect.tsx`      | API atslēgas atlasītājs                                         |
| `ManualConfigModal.tsx` | Kopējama konfigurācijas fragmenta modālais logs                 |

### Koplietojamais āķis (`src/shared/hooks/cli/`)

| Fails                     | Nolūks                                                                                    |
| ------------------------- | ----------------------------------------------------------------------------------------- |
| `useToolBatchStatuses.ts` | Iegūst datus no `/api/cli-tools/all-statuses`, pārvalda ielādes/atsvaidzināšanas stāvokli |

---

## 8. i18n

14. plānā F9 pievienotas jaunas nosaukumvietas:

| Nosaukumvieta | Mērķis                                                                                              |
| ------------- | --------------------------------------------------------------------------------------------------- |
| `cliCommon`   | Koplietojamas virknes (kartīšu etiķetes, koncepciju/salīdzinājumu teksti, detalizēto lapu etiķetes) |
| `cliCode`     | CLI Code lapas virknes                                                                              |
| `cliAgents`   | CLI Agents lapas virknes                                                                            |
| `acpAgents`   | ACP Agents lapas virknes                                                                            |

Ir nodrošināti pilni PT-BR un EN tulkojumi. 39 citām lokalizācijām automātiski tiek izmantots EN, pateicoties nosaukumvietu līmeņa sapludināšanai failā `src/i18n/request.ts`.

---

## 9. Ātrā darba sākšana

### 1. darbība — iegūstiet OmniRoute API atslēgu

1. Atveriet `/dashboard/api-manager` → **Izveidot API atslēgu**
2. Piešķiriet tai nosaukumu (piemēram, `cli-tools`) un atlasiet visas atļaujas
3. Nokopējiet atslēgu — tā būs nepieciešama katram tālāk norādītajam CLI

> Jūsu atslēga izskatās šādi: `sk-xxxxxxxxxxxxxxxx-xxxxxxxxx`

---

### 2. darbība — instalējiet CLI rīkus

Visiem uz npm balstītajiem rīkiem ir nepieciešams Node.js 22.22.2+ vai 24.x:

```bash
# Claude Code (Anthropic)
npm install -g @anthropic-ai/claude-code

# OpenAI Codex
npm install -g @openai/codex

# OpenCode
npm install -g opencode-ai

# Cline
npm install -g cline

# KiloCode
npm install -g kilocode

# Qwen Code
npm install -g @qwen-code/qwen-code

# Google Gemini CLI (palaižams ar `omniroute run gemini` → /v1beta saskarne)
npm install -g @google/gemini-cli

# Aider
pip install aider-chat

# Smelt
cargo install smelt  # Balstīts uz Rust

# Pi programmēšanas aģents
# instalēšanas norādījumus skatiet vietnē https://github.com/zechnerj/pi-coding-agent

# jcode
# instalēšanas norādījumus skatiet vietnē https://github.com/1jehuang/jcode
```

---

### 3. darbība — konfigurējiet informācijas panelī

1. Atveriet `http://localhost:20128/dashboard/cli-code`
2. Režģī atrodiet savu rīku
3. Noklikšķiniet uz kartītes, lai atvērtu rīka detalizēto lapu
4. Atlasiet savu API atslēgu un bāzes URL
5. Noklikšķiniet uz **Lietot konfigurāciju** vai nokopējiet manuālās konfigurācijas fragmentu

---

### 4. darbība — iestatiet globālos vides mainīgos

```bash
# OmniRoute universālais galapunkts
export OPENAI_BASE_URL="http://localhost:20128/v1"
export OPENAI_API_KEY="sk-your-omniroute-key"
export ANTHROPIC_BASE_URL="http://localhost:20128"
export ANTHROPIC_AUTH_TOKEN="sk-your-omniroute-key"
# Gemini CLI nolasa GOOGLE_GEMINI_BASE_URL SAKNES līmenī (tā SDK pats pievieno /v1beta/...)
export GOOGLE_GEMINI_BASE_URL="http://localhost:20128"
export GEMINI_API_KEY="sk-your-omniroute-key"
```

> **Attālam serverim** aizstājiet `localhost:20128` ar servera IP adresi vai domēnu,
> piemēram, `http://<your-server-ip>:20128`.

---

### 4. darbība — konfigurējiet katru rīku

#### Claude Code

```bash
# Izveidojiet ~/.claude/settings.json:
mkdir -p ~/.claude && cat > ~/.claude/settings.json << EOF
{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:20128",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-omniroute-key"
  }
}
EOF
```

Claude Code vajadzībām izmantojiet vienotās Anthropic vārtejas saknes adresi. Šeit nepievienojiet `/v1`.

**Pārbaude:** `claude "say hello"`

---

#### OpenAI Codex

Mūsdienu Codex (v0.137+) nolasa tikai `~/.codex/config.toml` — vecais
`config.yaml` pieder mantotajam npm CLI un tiek bez brīdinājuma ignorēts. API
atslēga paliek vides mainīgajā `OMNIROUTE_API_KEY` (`env_key`), nevis
failā:

```bash
mkdir -p ~/.codex && cat > ~/.codex/config.toml << EOF
model_provider = "omniroute"

[model_providers.omniroute]
name                 = "OmniRoute"
base_url             = "http://localhost:20128/v1"
env_key              = "OMNIROUTE_API_KEY"
requires_openai_auth = false
EOF
export OMNIROUTE_API_KEY="sk-your-omniroute-key"
```

Pilna atsauce (profili, `wire_api`, konteksta logi): [CODEX-CLI-CONFIGURATION.md](../guides/CODEX-CLI-CONFIGURATION.md).

**Pārbaude:** `codex "what is 2+2?"`

---

#### OpenCode

```bash
mkdir -p ~/.config/opencode && cat > ~/.config/opencode/opencode.json << EOF
{
  "\$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniRoute",
      "options": {
        "baseURL": "http://localhost:20128/v1",
        "apiKey": "sk-your-omniroute-key"
      },
      "models": {
        "claude-sonnet-4-5": { "name": "claude-sonnet-4-5" },
        "claude-sonnet-4-5-thinking": { "name": "claude-sonnet-4-5-thinking" },
        "gemini-3-flash": { "name": "gemini-3-flash" }
      }
    }
  }
}
EOF
```

**Pārbaude:** `opencode`

> Izmantojiet `opencode run "your prompt" --model omniroute/claude-sonnet-4-5-thinking --variant high`,
> lai nosūtītu domāšanas variantus.

---

#### Cline (CLI vai VS Code)

**CLI režīms:**

```bash
mkdir -p ~/.cline/data && cat > ~/.cline/data/globalState.json << EOF
{
  "apiProvider": "openai",
  "openAiBaseUrl": "http://localhost:20128/v1",
  "openAiApiKey": "sk-your-omniroute-key"
}
EOF
```

**VS Code režīms:**
Cline paplašinājuma iestatījumi → API nodrošinātājs: `OpenAI Compatible` → Bāzes URL: `http://localhost:20128/v1`

Vai izmantojiet OmniRoute informācijas paneli → **CLI rīki → Cline → Lietot konfigurāciju**.

---

#### KiloCode (CLI vai VS Code)

**CLI režīms:**

```bash
kilocode --api-base http://localhost:20128/v1 --api-key sk-your-omniroute-key
```

**VS Code iestatījumi:**

```json
{
  "kilo-code.openAiBaseUrl": "http://localhost:20128/v1",
  "kilo-code.apiKey": "sk-your-omniroute-key"
}
```

Vai izmantojiet OmniRoute informācijas paneli → **CLI rīki → KiloCode → Lietot konfigurāciju**.

---

#### Continue (VS Code paplašinājums)

Rediģējiet `~/.continue/config.yaml`:

```yaml
models:
  - name: OmniRoute
    provider: openai
    model: auto
    apiBase: http://localhost:20128/v1
    apiKey: sk-your-omniroute-key
    default: true
```

Pēc rediģēšanas restartējiet VS Code.

---

#### VS Code Insiders (`chatLanguageModels.json`)

Izmantojiet šo iespēju, ja VS Code Insiders ir konfigurēts pielāgotu galapunktu modeļiem un vēlaties, lai OmniRoute darbotos bez pielāgota galvenes lauka.

**Ieteicamā atrašanās vieta:**

- Linux: `~/.config/Code - Insiders/User/chatLanguageModels.json`
- Windows: `%APPDATA%/Code - Insiders/User/chatLanguageModels.json`

**Piemērs, izmantojot tokenizēto OmniRoute aizstājvārdu:**

```json
[
  {
    "vendor": "customendpoint",
    "id": "auto",
    "name": "OmniRoute Auto",
    "family": "gpt-4",
    "version": "1.0.0",
    "url": "http://localhost:20128/api/v1/vscode/sk-your-omniroute-key/chat/completions",
    "modelsUrl": "http://localhost:20128/api/v1/vscode/sk-your-omniroute-key/models",
    "requestFormat": "openai-chat-completions",
    "contextWindow": 256000,
    "maxOutputTokens": 32768,
    "auth": {
      "type": "none"
    }
  }
]
```

**Piezīmes:**

- Aizstājiet `sk-your-omniroute-key` ar OmniRoute izveidotu API atslēgu.
- Laukam `url` jānorāda uz `/api/v1/vscode/{token}/chat/completions`.
- Laukam `modelsUrl` jānorāda uz `/api/v1/vscode/{token}/models`.
- Ja klients atbalsta pielāgotas galvenes, dodiet priekšroku parastajai `/v1` plūsmai ar Bearer galveni.
- URL iegultie tokeni ir saderības rezerves risinājums, un tie var parādīties redaktora žurnālos vai starpniekservera vēsturē.

---

#### Kiro CLI (Amazon)

```bash
# Piesakieties savā AWS/Kiro kontā:
kiro-cli login

# CLI izmanto savu autentifikāciju — OmniRoute nav nepieciešams kā aizmugursistēma pašam Kiro CLI.
# Izmantojiet kiro-cli kopā ar OmniRoute citiem rīkiem.
kiro-cli status
```

**Kiro IDE** darbvirsmas lietotnei izmantojiet OmniRoute nodrošināto MITM galapunktu,
kas atrodas sadaļā `/dashboard/cli-tools → Kiro`.

---

## 10. Iekšējais OmniRoute CLI

`omniroute` binārais fails nodrošina komandas servera dzīves cikla pārvaldībai, iestatīšanai, diagnostikai un pakalpojumu sniedzēju pārvaldībai. Ieejas punkts: `bin/omniroute.mjs`.

```bash
omniroute                              # Palaist serveri (noklusējuma ports 20128)
omniroute setup                        # Interaktīvs iestatīšanas vednis
omniroute doctor                       # Pārbaudīt konfigurāciju, DB, portus un izpildlaika vidi
omniroute providers list               # Konfigurētie pakalpojumu sniedzēju savienojumi
omniroute providers test-all           # Pārbaudīt katru aktīvo savienojumu
omniroute reset-password               # Atiestatīt administratora paroli
omniroute logs                         # Straumēt pieprasījumu žurnālus
omniroute health                       # Detalizēts darbspējas statuss (slēdži, kešatmiņa, atmiņa)
omniroute --version                    # Izvadīt versiju
omniroute --help                       # Parādīt visas komandas
```

### Iestatīšana un inicializācija

```bash
omniroute setup                        # Interaktīvs iestatīšanas vednis
omniroute setup --non-interactive      # CI/automatizācijas režīms (nolasa vides mainīgos un karogus)
omniroute setup --password '<value>'   # Tieši iestatīt administratora paroli
omniroute setup --add-provider \
  --provider openai \
  --api-key '<value>' \
  --test-provider                      # Pievienot un pārbaudīt pakalpojumu sniedzēju vienā darbībā
```

Atpazītie vides mainīgie neinteraktīvai iestatīšanai:

| Mainīgais           | Nolūks                                                                                     |
| ------------------- | ------------------------------------------------------------------------------------------ |
| `OMNIROUTE_API_KEY` | Pakalpojumu sniedzēja API atslēga (piesaistīta `--api-key`, izmantojot Commander `.env()`) |
| `DATA_DIR`          | Aizstāt OmniRoute datu direktoriju                                                         |

Visas pārējās neinteraktīvās ievades tiek nodotas kā karogi, nevis vides mainīgie:
`--password`, `--provider`, `--provider-name`, `--provider-base-url`, `--default-model`
(skatiet iepriekš norādītās `omniroute setup` opcijas).

### Diagnostika

```bash
omniroute doctor                       # Pārbaudīt konfigurāciju, DB, portus, izpildlaika vidi, atmiņu un darbspēju
omniroute doctor --json                # Mašīnlasāms JSON
omniroute doctor --no-liveness         # Izlaist HTTP darbspējas pārbaudi
omniroute doctor --host 0.0.0.0        # Aizstāt darbspējas pārbaudes resursdatoru
omniroute doctor --liveness-url <url>  # Aizstāt pilno darbspējas galapunkta URL
```

Komanda doctor veic šādas pārbaudes: `Config`, `Database`, `Storage/encryption`,
`Port availability`, `Node runtime`, `Native binary` (better-sqlite3),
`Memory` un `Server liveness`. Tā beidz darbu ar kodu, kas nav nulle, ja kādas pārbaudes rezultāts ir `fail`.

### Pakalpojumu sniedzēju pārvaldība

```bash
omniroute providers available                       # OmniRoute pakalpojumu sniedzēju katalogs
omniroute providers available --search openai       # Filtrēt katalogu pēc ID/nosaukuma/aizstājvārda/kategorijas
omniroute providers available --category api-key    # Filtrēt pēc kategorijas (api-key, oauth, free, ...)
omniroute providers available --json                # Mašīnlasāms JSON

omniroute providers list                            # Konfigurētie pakalpojumu sniedzēju savienojumi
omniroute providers list --json

omniroute providers test <id|name>                  # Pārbaudīt vienu konfigurētu savienojumu
omniroute providers test-all                        # Pārbaudīt katru aktīvo savienojumu
omniroute providers validate                        # Tikai lokāla strukturālā validācija
omniroute providers add <provider> --credential-env PROVIDER_KEY
omniroute providers import ./providers.json --dry-run --json
omniroute providers auth <provider>                 # Esošā OAuth plūsma
omniroute providers edit <id|name> --default-model <model>
omniroute providers remove <id|name> --yes
```

`providers add/import/auth/edit/remove` primāri izmanto API un tādēļ darbojas ar
aktīvo lokālo vai attālo kontekstu. Akreditācijas datu ievadei jāizmanto
`--credential-stdin` vai `--credential-env`; `--dry-run --json` ziņo tikai par
rediģētu esamību/formu. `providers available` nolasa OmniRoute katalogu;
`providers list/test/test-all/validate` saglabā savu lokālo SQLite darbību, un
tiem nav nepieciešams, lai serveris darbotos.

Pielāgotam ar OpenAI vai Anthropic saderīgam mezglam piesaistiet akreditācijas datus
mezgla ID, ko atgriež `omniroute nodes add`, izmantojot `omniroute keys add "$NODE_ID" --stdin`.
Tam nepieciešams darbojošs serveris un pārvaldības autentifikācija aktīvajam kontekstam.
CLI izmanto `POST /api/providers`, kas validē mezglu un kopē tā galapunkta
iestatījumus savienojumā. Ja mezgls nav atrasts, autorizācija neizdodas vai serveris
nav pieejams, tiek atgriezta kļūda, neveidojot lokālu rezerves akreditācijas ierakstu.

`nodes add --base-url` iestata mezgla galapunktu; tas atšķiras no servera adreses,
kas norādīta `OMNIROUTE_BASE_URL`. OpenAPI failiem izmantojiet
`omniroute openapi dump --format json --out ./openapi.json`; globālā opcija `--output`
atlasa CLI attēlošanas formatējumu, nevis mērķa faila nosaukumu.

### Atkopšana un atiestatīšana

```bash
omniroute reset-password                # Atiestatīt administratora paroli (arī: omniroute-reset-password)
omniroute reset-encrypted-columns       # Parādīt brīdinājumu un izmēģinājuma režīmu šifrēto akreditācijas datu atiestatīšanai
omniroute reset-encrypted-columns --force  # Faktiski aizstāt šifrētos akreditācijas datus SQLite ar null
```

### Akreditācijas datu eksportēšana (⚠ rīkojieties piesardzīgi)

```bash
omniroute auth export                                 # Parādīt brīdinājumu un pieprasīt apstiprinājumu — bez piekļuves DB
omniroute auth export --force                          # Eksportēt VISU savienojumu ATŠIFRĒTOS akreditācijas datus uz stdout JSON formātā
omniroute auth export --force --id <id>                 # Eksportēt tikai atbilstošo savienojumu
omniroute auth export --force --format env               # Izvadīt OMNIROUTE_<PROVIDER>_<FIELD>=<value> rindas
omniroute auth export --force --out creds.json           # Ierakstīt failā (izveidots ar 0600 atļaujām)
```

`auth export` darbojas **tikai lokāli** (tieša SQLite lasīšana, bez HTTP maršruta) un apzināti izvada/raksta
**vienkārša teksta** `apiKey`/`accessToken`/`refreshToken`/`idToken` vērtības — tā ir funkcionalitāte, nevis
kļūda. Bez `--force` nekas netiek lasīts no datubāzes un nekas netiek atšifrēts. Pirms jebkāda vienkārša teksta izvades
vienmēr tiek parādīts brīdinājuma baneris stderr plūsmā. Nepieciešams, lai būtu iestatīts `STORAGE_ENCRYPTION_KEY`.
Lauks, kuru neizdodas atšifrēt (novecojusi atslēga, bojāts šifrētais teksts), tiek norādīts kā
`<field>DecryptFailed: true`, nevis tiek pārtraukts viss eksports vai atklāta pamatā esošā kļūda.

### Citas apakškomandas

Ja vien nav norādīts citādi, tās pieņem, ka darbojas OmniRoute serveris:

```bash
omniroute status                       # Visaptverošs izpildlaika statuss
omniroute logs                         # Pieprasījumu žurnālu straumēšana (--json, --search, --follow)
omniroute config list                  # Konfigurēto CLI rīku parādīšana

omniroute provider list                # Pieejamo pakalpojumu sniedzēju saraksts (providers list aizstājvārds)
omniroute provider add                 # OmniRoute reģistrēšana rīkā kā pakalpojumu sniedzēju
omniroute keys add | list | remove     # API atslēgu pārvaldība
omniroute models [provider]            # Modeļu saraksts (--json, --search)
omniroute combo list | switch | create | delete

omniroute backup                       # Konfigurācijas un DB momentuzņēmuma izveide
omniroute restore                      # Atjaunošana no iepriekšēja momentuzņēmuma

omniroute health                       # Detalizēts darbspējas stāvoklis (slēdži, kešatmiņa, atmiņa)
omniroute quota                        # Pakalpojumu sniedzēja kvotas lietojums
omniroute cache                        # Kešatmiņas statuss
omniroute cache clear                  # Semantiskās un parakstu kešatmiņas notīrīšana

omniroute mcp status | restart         # MCP servera statuss / restartēšana
omniroute a2a status | card            # A2A servera statuss / aģenta kartīte

omniroute tunnel list | create | stop  # Tuneļu pārvaldība (cloudflare/tailscale/ngrok)
omniroute env show | get <k> | set <k> <v>  # Vides mainīgo apskate / iestatīšana (īslaicīgi)

omniroute test                         # Pakalpojumu sniedzēja savienojamības ātrā pārbaude
omniroute update                       # Atjauninājumu pārbaude
omniroute completion                   # Čaulas automātiskās pabeigšanas ģenerēšana
```

### Biežāk lietotie karodziņi

| Karodziņš           | Apraksts                                                   |
| ------------------- | ---------------------------------------------------------- |
| `--no-open`         | Startēšanas laikā automātiski neatvērt pārlūkprogrammu     |
| `--port <n>`        | Pārrakstīt API portu (noklusējums: 20128)                  |
| `--mcp`             | Darbināt kā MCP serveri, izmantojot stdio (IDE vajadzībām) |
| `--non-interactive` | CI režīms (bez uzvednēm; nolasa no vides/karodziņiem)      |
| `--json`            | Mašīnlasāma JSON izvade (doctor, providers utt.)           |
| `--help`, `-h`      | Parādīt konkrētās komandas palīdzību                       |
| `--version`, `-v`   | Izvadīt instalēto versiju                                  |

---

## Pieejamie API galapunkti

| Galapunkts                 | Apraksts                                 | Lietojums                          |
| -------------------------- | ---------------------------------------- | ---------------------------------- |
| `/v1/chat/completions`     | Standarta tērzēšana (visi nodrošinātāji) | Visi mūsdienīgie rīki              |
| `/v1/responses`            | Responses API (OpenAI formāts)           | Codex, aģentu darbplūsmas          |
| `/v1/completions`          | Mantotā teksta pabeigšana                | Vecāki rīki, kas izmanto `prompt:` |
| `/v1/embeddings`           | Teksta iegulumi                          | RAG, meklēšana                     |
| `/v1/images/generations`   | Attēlu ģenerēšana                        | GPT-Image, Flux utt.               |
| `/v1/audio/speech`         | Teksta pārvēršana runā                   | ElevenLabs, OpenAI TTS             |
| `/v1/audio/transcriptions` | Runas pārvēršana tekstā                  | Deepgram, AssemblyAI               |

Ielīmēšanai gatavi piemēri ar tokenizētu OmniRoute URL:

```txt
Tokena piemērs: sk-a3ab3c080beaee3a-69f4a4-070d71af

Standarta OpenAI bāzes URL: http://localhost:20128/v1
VS Code modeļi: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/models
VS Code tērzēšana: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/chat/completions
VS Code atbildes: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/responses
Ollama tagi: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/api/tags
Ollama tērzēšana: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/api/chat
```

---

## Problēmu novēršana

| Kļūda                                                       | Cēlonis                                | Risinājums                                                       |
| ----------------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------- |
| `Connection refused`                                        | OmniRoute nedarbojas                   | `omniroute serve`                                                |
| `401 Unauthorized`                                          | Nepareiza API atslēga                  | Pārbaudiet sadaļā `/dashboard/api-manager`                       |
| `No combo configured`                                       | Nav aktīvas maršrutēšanas kombinācijas | Iestatiet sadaļā `/dashboard/combos`                             |
| CLI rāda „nav instalēts”                                    | Binārais fails nav PATH                | Pārbaudiet ar `which <command>`                                  |
| Pēc instalēšanas informācijas panelī redzams „nav noteikts” | Kešatmiņa ir novecojusi                | Informācijas panelī noklikšķiniet uz „⟳ Atsvaidzināt noteikšanu” |
| Vecā saite `/dashboard/cli-tools`                           | Grāmatzīme no versijas pirms v3.8.6    | Automātiski novirzīta uz `/dashboard/cli-code` (308)             |
| Vecā saite `/dashboard/agents`                              | Grāmatzīme no versijas pirms v3.8.6    | Automātiski novirzīta uz `/dashboard/acp-agents` (308)           |

## Secinājumu atslēgas politikas pārvaldība ar OmniRoute CLI

Izmantojiet autentificētu pārvaldības kontekstu (skatiet [Attālais režīms](../guides/REMOTE-MODE.md)),
lai pārbaudītu vai atjauninātu esošu secinājumu atslēgu pēc tās ID:

```bash
omniroute --output json keys policy show KEY_ID
omniroute keys policy set KEY_ID --unrestricted
omniroute --output json keys policy show KEY_ID
```

`--unrestricted` ir `--model-access-mode all` aizstājvārds. Atjaunināšana notīra
atļauto modeļu sarakstu. Tā saglabā tvērumus, savienojumu noteikumus, bloķētos modeļus, ātruma ierobežojumus
un izmaksu ierobežojumus, tāpēc šie pārējie kontroles mehānismi joprojām var noraidīt pieprasījumu. Arī nepārprotams
`--allowed-models ""` atlasa `all`; kombinējiet to ar
`--model-access-mode restricted`, lai saglabātu ierobežotu atslēgu bez atļautiem modeļiem.
Netukšs, ar komatiem atdalīts saraksts atlasa `restricted`, ja vien nav nepārprotami norādīts citādi.
Pretrunīga `all` un netukša atļauto modeļu saraksta kombinācija tiek noraidīta pirms pieprasījuma nosūtīšanas.

`--rate-limit 30` iestata pieprasījumu skaitu minūtē un saglabā noteikumus citiem laika
logiem. `--max-cost 5` iespējo dienas ierobežojumu USD, nemainot nedēļas ierobežojumu;
`--max-cost 0` noņem dienas ierobežojumu un saglabā esošo lietojuma ierobežojuma slēdzi
un nedēļas ierobežojumu. Izlaistie politikas lauki paliek nemainīti. Ātruma izmaiņu gadījumā vispirms tiek nolasīta
pašreizējā politika; neveiciet vienlaicīgas izmaiņas vienas un tās pašas atslēgas ātruma ierobežojumu masīvā.

Politikas komandas izmanto autentificētus `GET`/`PATCH /api/keys/{id}` pieprasījumus un ievēro aktīvo
kontekstu un globālo `--api-key` opciju. JSON izvade satur tikai politikas laukus,
bez saglabātās atslēgas vai tās maskētā attēlojuma. Akreditācijas dati, kas paredzēti tikai secinājumu veikšanai,
nevar autorizēt pārvaldības izmaiņas. 401/403 kļūdas gadījumā jāpārbauda pārvaldības
akreditācijas dati un konteksts; tā neliecina par lokālā CLI tokena vai sāls kļūmi.
Atsevišķo lokālās autentifikācijas līgumu skatiet sadaļā [CLI tokens](../security/CLI_TOKEN.md).