# CLI Tools — OmniRoute (Hrvatski)

🌐 **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) · 🇭🇺 [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) · 🇱🇻 [lv](../../../lv/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)

---

Posljednje ažuriranje: 2026-08-23

OmniRoute se integrira s trima kategorijama CLI alata raspoređenima na tri namjenske stranice nadzorne ploče:

| Stranica       | Ruta                    | Koncept                                                                                   | Broj          |
| -------------- | ----------------------- | ----------------------------------------------------------------------------------------- | ------------- |
| **CLI kodovi** | `/dashboard/cli-code`   | Alati za kodiranje koje usmjeravate na OmniRoute (Klijent → CLI → OmniRoute → Pružatelj)  | 26            |
| **CLI agenti** | `/dashboard/cli-agents` | Autonomni agenti koje usmjeravate na OmniRoute (isti tijek, širi opseg)                   | 10            |
| **ACP agenti** | `/dashboard/acp-agents` | CLI alati koje OmniRoute pokreće kao pozadinske sustave putem stdio/ACP-a (obrnuti tijek) | vidi registar |

Naslijeđene rute preusmjeravaju putem statusa 308: `/dashboard/cli-tools` → `/dashboard/cli-code`, `/dashboard/agents` → `/dashboard/acp-agents`.

---

## Kako funkcionira

```
CLI Code's / CLI Agents (tok potrošnje):
Claude / Codex / OpenCode / Cline / KiloCode / Continue / Hermes Agent / Goose / ...
           │
           ▼  (svi usmjeravaju na OmniRoute)
    http://YOUR_SERVER:20128/v1
           │
           ▼  (OmniRoute preusmjerava na odgovarajućeg pružatelja)
    Anthropic / OpenAI / Gemini / DeepSeek / Groq / Mistral / ...

ACP Agents (tok obrnutog pokretanja):
    Zahtjev klijenta → OmniRoute → pokreće CLI putem stdio/ACP → odgovor
```

**Prednosti:**

- Jedan API ključ za upravljanje svim alatima
- Praćenje troškova svih CLI-jeva unutar nadzorne ploče
- Promjena modela bez ponovnog konfiguriranja svakog alata
- Radi lokalno i na udaljenim poslužiteljima (VPS, Docker, Akamai, Cloudflare Tunnel)

---

## Automatsko konfiguriranje s `setup-*`

Ne morate ručno pisati konfiguraciju svakog alata. OmniRoute isporučuje `setup-*` naredbu za svaki podržani CLI koja čita **živi** katalog modela iz pokrenutog OmniRoutea (lokalnog ili udaljenog) i zapisuje vlastitu konfiguraciju alata na vaše računalo:

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

Svaka prihvaća `--remote <url> --api-key <key>` (konfigurira lokalni alat prema udaljenom OmniRouteu), `--dry-run` (pregled bez pisanja) i `--port`. Alati bez automatskog otkrivanja modela (Cline, Kilo, Roo, Goose, Aider, Qwen, 5dive) prihvaćaju `--model <id>` (i `--yes` za neinteraktivna pokretanja). `setup-5dive` je jedini recept koji ne piše pod `$HOME`: on konfigurira flotu agenata 5dive pisanjem profila za autentifikaciju u vlasništvu roota na hostu flote, tako da se ponovno izvršava putem `sudo` i nema vlastiti udaljeni način rada. Za pokretanje CLI-ja s ispravno injektiranim okruženjem i bez ikakve napisane konfiguracije, koristite generički pokretač `omniroute run <target>` (claude, codex, aider, goose, opencode, qwen, gemini — ciljevi i aliasi dolaze iz `bin/cli/cli-manifest.mjs`); naslijeđeni pokretači po alatu `omniroute launch` (Claude Code) i `omniroute launch-codex` (Codex) ostaju dostupni. Gemini CLI je samo za pokretanje: to je `omniroute run` cilj, ali nema `setup-*`/`configure` recept.

> **Potpuna referenca:** glavna tablica — što svaka naredba piše, svaka zastavica, lokalno naspram udaljenog, i koji alati žele `/v1` sufiks — nalazi se u **[CLI Integrations](../guides/CLI-INTEGRATIONS.md)**.

### Pokretanje ovih unutar spremnika

`setup-*` naredba izvršena unutar OmniRoute spremnika piše u vlastiti dom spremnika, što nijedan host CLI ne čita i što nestaje sa spremnikom. OmniRoute to detektira i izlazi s `2` i uputama umjesto pisanja. Dva podržana načina su — instalirati CLI na host i `omniroute connect` na spremnik, ili bind-mountati konfiguracijske direktorije i postaviti `CLI_CONFIG_HOME` (compose `host` profil). Svaka `setup-*` naredba, plus `omniroute configure` i `omniroute config set`, prihvaća `--allow-container-write` kada ste zapravo mislili na konfiguriranje vlastitih CLI-ja spremnika; `OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE=true` čini isto za poslužitelj. Pogledajte [Docker vodič → Konfiguriranje CLI alata hosta](../guides/DOCKER_GUIDE.md#configuring-host-cli-tools-when-omniroute-runs-in-docker).

Nadzorna ploča **apply endpoint** (`POST /api/cli-tools/apply`) primjenjuje istu zaštitu: u spremniku, pisanje čiji cilj nije bind-mountan s hosta odgovara s **`422`** s `containerEphemeralTarget: true`, sigurnim tekstom pogreške i — za alate s host receptom (claude, codex, opencode, cline, kilo, continue) — `hostSetupCommand` (npr. `omniroute setup-opencode`) za pokretanje na hostu umjesto toga; ništa se ne piše. `dryRun: true` nastavlja raditi u načinu rada spremnika i vraća redigirani pregled + ciljnu putanju bez dodirivanja diska. Sadržaj pregleda nije konfiguracija koja sadrži vjerodajnice za kopiranje ili uvoz. Primijenite s originalnim alatom/osnovnim URL-om/API ključem/ulazima modela na hostu, ili koristite naznačenu naredbu za postavljanje na strani hosta. Pogledajte [Sigurnost CLI konfiguracije](../security/CLI-CONFIGURATION.md) za zaglavlje pregleda i ugovor zahtjeva. Ovo ponašanje je namjerno i zaštićeno od regresije putem `tests/unit/api/cli-tools/apply-container-guard.test.ts` — nikada nemojte "popravljati" 422 uklanjanjem zaštite.

---

## Izvor istine

Objedinjeni katalog nalazi se u `src/shared/constants/cliTools.ts` kao `CLI_TOOLS: Record<string, CliCatalogEntry>`.

Svaki unos ima sljedeća polja (definirana u `src/shared/schemas/cliCatalog.ts`):

| Polje                                           | Tip                                                          | Opis                                                                  |
| ----------------------------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------- |
| `category`                                      | `"code" \| "agent"`                                          | Na kojoj se stranici alat prikazuje                                   |
| `vendor`                                        | `string`                                                     | Podrijetlo alata ("Anthropic", "OSS (P. Gauthier)")                   |
| `acpSpawnable`                                  | `boolean`                                                    | Može se koristiti i kao ACP Agent (prikazuje se značka)               |
| `baseUrlSupport`                                | `"full" \| "partial" \| "none"`                              | Razina podrške za prilagođenu krajnju točku. `"none"` = MITM zaostaci |
| `configType`                                    | `"env" \| "custom" \| "guide" \| "custom-builder" \| "mitm"` | Mehanizam konfiguracije                                               |
| `id`, `name`, `color`, `description`, `docsUrl` | standardno                                                   | Osnovna polja za prikaz                                               |

Unosi s `baseUrlSupport: "none"` **nisu prikazani** na stranicama nadzorne ploče — registrirani su u MITM zaostacima za plan 11 (pogledajte `_tasks/features-v3.8.6/refactorpages/_orchestration/_plan11-mitm-backlog.md`).

### Razine mogućnosti (katalogizirano × otkrivljivo × konfigurabilno × pokretljivo)

Nije svaki katalogizirani alat otkrivljiv, konfigurabilam ili pokretljiv. Svaka razina ima jedan
izvor deklaracije, a test za otkrivanje odstupanja održava ih usklađenima:

| Razina             | Značenje                                                                                    | Deklarirano u                                                     |
| ------------------ | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| **Katalogizirano** | Prikazuje se u katalogu nadzorne ploče (naziv, dobavljač, dokumentacija, tip konfiguracije) | `src/shared/constants/cliTools.ts` (`CLI_TOOLS`)                  |
| **Otkrivljivo**    | Otkrivanje binarne datoteke/konfiguracije, provjere zdravlja, putanje konfiguracije         | `src/shared/services/cliRuntime.ts` (izvodni katalog `CLI_TOOLS`) |
| **Konfigurabilno** | Podržava `omniroute configure <cli>` (postoji recept za postavljanje)                       | `bin/cli/cli-manifest.mjs` (`configure: true`)                    |
| **Pokretljivo**    | Podržava `omniroute run <target>` (definirana injekcija env/args)                           | `bin/cli/cli-manifest.mjs` (`run: true`)                          |

`bin/cli/cli-manifest.mjs` je kanonski izvršni manifest za površine CLI naredbi:
`run`, `configure` i generatori dovršavanja ljuske izvode svoje
popise ciljeva, razrješavanje pseudonima (na primjer `kilocode`/`kilo-code`/`kilo_cli` → `kilo`)
i povezivanje zastavice `--model` iz njega. Čuvar odstupanja
`tests/unit/cli/cli-manifest-drift.test.ts` potvrđuje da manifest, izvodni
katalog, UI katalog i sve površine potrošača ostaju sinkronizirani — cilj dodan jednoj
površini bez ostalih ne uspijeva u paketu testova umjesto da tiho odstupa.

---

## 1. Katalog CLI koda (26 alata)

Svi alati koji se pojavljuju u `/dashboard/cli-code`. Oni s `baseUrlSupport: none` povezani su putem MITM-a ili ručnog vodiča umjesto prilagođenog osnovnog URL-a:

| id           | naziv                      | dobavljač              | baseUrlSupport | configType     | acpSpawnable |
| ------------ | -------------------------- | ---------------------- | -------------- | -------------- | ------------ |
| claude       | Claude Code                | Anthropic              | full           | env            | true         |
| codex        | OpenAI Codex CLI           | OpenAI                 | full           | custom         | true         |
| zcode        | ZCode (GLM plan kodiranja) | Z.ai                   | none           | custom         | false        |
| cline        | Cline                      | OSS (bivši 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 (bivši 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-agent za kodiranje) | 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       | Prilagođeni CLI            | —                      | full           | custom-builder | false        |

Alati s `baseUrlSupport: "partial"` prikazuju značku "⚠ Djelomični osnovni URL" na kartici nadzorne ploče.
---

## 2. Katalog CLI agenata (10 alata)

Autonomni agenti koji se pojavljuju u `/dashboard/cli-agents`:

| id           | naziv            | dobavljač                | podrška za baseUrl | moguće pokretanje putem ACP-a |
| ------------ | ---------------- | ------------------------ | ------------------ | ----------------------------- |
| hermes-agent | Hermes Agent     | Nous Research            | potpuna            | ne                            |
| openclaw     | OpenClaw         | OSS (P. Steinberger)     | potpuna            | da                            |
| goose        | Goose            | Block / Linux Foundation | potpuna            | da                            |
| interpreter  | Open Interpreter | OSS                      | potpuna            | da                            |
| warp         | Warp AI          | Warp Inc.                | djelomična         | da                            |
| agent-deck   | Agent Deck       | asheshgoplani (OSS)      | potpuna            | ne                            |
| omp          | Oh My Pi         | OSS                      | potpuna            | da                            |
| letta        | Letta CLI        | Letta                    | potpuna            | ne                            |
| prime-agent  | Prime Agent      | Prime Intellect (OSS)    | potpuna            | ne                            |
| 5dive        | 5dive            | OSS (5dive-ai)           | potpuna            | ne                            |

---

## 3. ACP agenti (/dashboard/acp-agents)

Ova stranica (preimenovana iz `/dashboard/agents`) prikazuje CLI-ove koje OmniRoute može **pokrenuti** kao pozadinske izvršne pogone putem stdio/ACP protokola. Katalog se zasebno održava u `src/lib/acp/registry.ts` i **nije** isti kao `CLI_TOOLS`.

---

## 4. MITM zaostatak (nije prikazano na nadzornoj ploči)

Sljedeći CLI-ovi ne podržavaju prilagođeni osnovni URL izvorno i **nisu navedeni** na stranicama CLI koda ili CLI agenata. Kandidati su za MITM presretanje u planu 11:

| CLI                 | Razlog                                                            |
| ------------------- | ----------------------------------------------------------------- |
| windsurf            | BYOK ograničen na odabrane Claude modele + korporativni URL/token |
| amp                 | Zatvoreni ekosustav (Sourcegraph)                                 |
| amazon-q / kiro-cli | AWS SSO autentifikacija, bez prilagođenog URL-a                   |
| cowork              | Anthropic Desktop, bez konfigurabilnog krajnjeg točke             |

Pogledajte `_tasks/features-v3.8.6/refactorpages/_orchestration/_plan11-mitm-backlog.md` za potpunu unakrsnu referencu.

---

## 5. API za skupno otkrivanje

Sve detekcije alata agregiraju se putem jedne krajnje točke:

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

- Autentifikacija: `requireCliToolsAuth(request)` (isto kao i ostale rute `/api/cli-tools/`)
- Vraća: `Record<toolId, ToolBatchStatus>` (tip: `src/shared/types/cliBatchStatus.ts`)
- Strategija: `Promise.all` nad svim alatima, vremensko ograničenje od 5 s po alatu
- Predmemorija: LRU u memoriji indeksiran prema `mtime` konfiguracijske datoteke. Predmemorija se poništava kada se mtime promijeni. Resetira se pri ponovnom pokretanju poslužitelja.

Oblik odgovora po alatu:

```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; // sanirano, bez tragova stoha
}
```

---

## 6. Handleri Postavki za Nove Alate

Novi alati s `configType: "custom"` imaju namjenske API rute za postavke:

| Ruta                                        | Alat                                                                             |
| ------------------------------------------- | -------------------------------------------------------------------------------- |
| `POST /api/cli-tools/forge-settings`        | ForgeCode (.forge.toml)                                                          |
| `POST /api/cli-tools/jcode-settings`        | jcode (zastavica --base-url)                                                     |
| `POST /api/cli-tools/deepseek-tui-settings` | DeepSeek TUI (OPENAI_BASE_URL, naslijeđeno)                                      |
| `POST /api/cli-tools/codewhale-settings`    | CodeWhale (OPENAI_BASE_URL, primarno + naslijeđena `~/.deepseek` sinkronizacija) |
| `POST /api/cli-tools/smelt-settings`        | Smelt                                                                            |
| `POST /api/cli-tools/pi-settings`           | Pi coding agent                                                                  |
| `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` + namjenski `.env` ključ)                     |

Sve rute koriste `sanitizeErrorMessage()` za odgovore s greškama (Tvrdo Pravilo #12).

---

## 7. Arhitektura Stranica Nadzorne Ploče

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

- `src/app/(dashboard)/dashboard/cli-code/page.tsx` — serverska komponenta
- `src/app/(dashboard)/dashboard/cli-code/CliCodePageClient.tsx` — klijentska mreža
- `src/app/(dashboard)/dashboard/cli-code/[id]/page.tsx` — stranica detalja alata
- `src/app/(dashboard)/dashboard/cli-code/components/` — 12 specijaliziranih kartica alata + `ToolDetailClient.tsx`

### CLI Agents (`/dashboard/cli-agents`)

- `src/app/(dashboard)/dashboard/cli-agents/page.tsx` — serverska komponenta
- `src/app/(dashboard)/dashboard/cli-agents/CliAgentsPageClient.tsx` — klijentska mreža
- `src/app/(dashboard)/dashboard/cli-agents/[id]/page.tsx` — ponovo koristi `ToolDetailClient`

### ACP Agents (`/dashboard/acp-agents`)

- `src/app/(dashboard)/dashboard/acp-agents/page.tsx` — serverska komponenta (premješteno iz `agents/`)

### Dijeljene UI Komponente (`src/shared/components/cli/`)

| Datoteka                | Svrha                                                                |
| ----------------------- | -------------------------------------------------------------------- |
| `CliToolCard.tsx`       | Pametna statusna kartica (detekcija + konfiguracija + krajnja točka) |
| `CliConceptCard.tsx`    | Kartica s objašnjenjem koncepta po stranici                          |
| `CliComparisonCard.tsx` | Usporedba u tri stupca između CLI vrsta                              |
| `BaseUrlSelect.tsx`     | Padajući izbornik krajnje točke (Lokalno/Oblak/Prilagođeno)          |
| `ApiKeySelect.tsx`      | Odabir API ključa                                                    |
| `ManualConfigModal.tsx` | Modalni prozor s isječkom konfiguracije za kopiranje                 |

### Dijeljeni Hook (`src/shared/hooks/cli/`)

| Datoteka                  | Svrha                                                                           |
| ------------------------- | ------------------------------------------------------------------------------- |
| `useToolBatchStatuses.ts` | Dohvaća `/api/cli-tools/all-statuses`, upravlja stanjem učitavanja/osvježavanja |

---

## 8. i18n

Novi prostori imena dodani u planu 14 F9:

| Prostor imena | Svrha                                                                                     |
| ------------- | ----------------------------------------------------------------------------------------- |
| `cliCommon`   | Zajednički nizovi (oznake kartica, tekstovi koncepata/usporedbi, oznake stranice detalja) |
| `cliCode`     | Nizovi stranice CLI Code                                                                  |
| `cliAgents`   | Nizovi stranice CLI Agents                                                                |
| `acpAgents`   | Nizovi stranice ACP Agents                                                                |

Dostupni su potpuni prijevodi na PT-BR i EN. Ostalih 39 jezičnih postavki automatski koristi EN kao zamjenski jezik putem spajanja na razini prostora imena u `src/i18n/request.ts`.

---

## 9. Brzi početak

### Korak 1 — Dohvatite OmniRoute API ključ

1. Otvorite `/dashboard/api-manager` → **Create API Key**
2. Dodijelite mu naziv (npr. `cli-tools`) i odaberite sve dozvole
3. Kopirajte ključ — trebat će vam za svaki CLI alat u nastavku

> Vaš ključ izgleda ovako: `sk-xxxxxxxxxxxxxxxx-xxxxxxxxx`

---

### Korak 2 — Instalirajte CLI alate

Svi alati temeljeni na npm-u zahtijevaju Node.js 22.22.2+ ili 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 (može se pokrenuti putem `omniroute run gemini` → /v1beta površina)
npm install -g @google/gemini-cli

# Aider
pip install aider-chat

# Smelt
cargo install smelt  # Temeljen na Rustu

# Pi coding agent
# pogledajte https://github.com/zechnerj/pi-coding-agent za instalaciju

# jcode
# pogledajte https://github.com/1jehuang/jcode za instalaciju
```

---

### Korak 3 — Konfigurirajte putem nadzorne ploče

1. Idite na `http://localhost:20128/dashboard/cli-code`
2. Pronađite svoj alat u mreži
3. Kliknite karticu kako biste otvorili stranicu s detaljima alata
4. Odaberite svoj API ključ i osnovni URL
5. Kliknite **Apply Config** ili kopirajte isječak za ručnu konfiguraciju

---

### Korak 4 — Postavite globalne varijable okruženja

```bash
# OmniRoute univerzalna krajnja točka
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 čita GOOGLE_GEMINI_BASE_URL na KORIJENSKOJ razini (njegov SDK sam dodaje /v1beta/...)
export GOOGLE_GEMINI_BASE_URL="http://localhost:20128"
export GEMINI_API_KEY="sk-your-omniroute-key"
```

> Za **udaljeni poslužitelj** zamijenite `localhost:20128` s IP adresom ili domenom poslužitelja,
> npr. `http://<your-server-ip>:20128`.

---

### Korak 4 — Konfigurirajte svaki alat

#### Claude Code

```bash
# Stvorite ~/.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
```

Koristite objedinjeni Anthropic pristupnik (root) za Claude Code. Nemojte ovdje dodavati `/v1`.

**Test:** `claude "say hello"`

---

#### OpenAI Codex

Moderni Codex (v0.137+) čita isključivo `~/.codex/config.toml` — stari
`config.yaml` pripada zastarjelom npm CLI-ju i tiho se ignorira. API
ključ ostaje u varijabli okruženja `OMNIROUTE_API_KEY` (`env_key`), nikada
unutar datoteke:

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

Potpuna referenca (profili, `wire_api`, kontekstni prozori): [CODEX-CLI-CONFIGURATION.md](../guides/CODEX-CLI-CONFIGURATION.md).

**Test:** `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
```

**Test:** `opencode`

> Koristite `opencode run "your prompt" --model omniroute/claude-sonnet-4-5-thinking --variant high`
> za slanje varijanti s razmišljanjem.

---

#### Cline (CLI ili VS Code)

**CLI način:**

```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 način:**
Postavke proširenja Cline → API Provider: `OpenAI Compatible` → Base URL: `http://localhost:20128/v1`

Ili koristite OmniRoute nadzornu ploču → **CLI Tools → Cline → Apply Config**.

---

#### KiloCode (CLI ili VS Code)

**CLI način:**

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

**VS Code postavke:**

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

Ili koristite OmniRoute nadzornu ploču → **CLI Tools → KiloCode → Apply Config**.

---

#### Continue (VS Code proširenje)

Uredite `~/.continue/config.yaml`:

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

Ponovno pokrenite VS Code nakon uređivanja.

---

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

Koristite ovo kada je VS Code Insiders konfiguriran za modele s prilagođenim krajnjim točkama i želite da OmniRoute radi bez prilagođenog polja zaglavlja.

**Preporučena lokacija:**

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

**Primjer s tokeniziranim OmniRoute aliasom:**

```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"
    }
  }
]
```

**Napomene:**

- Zamijenite `sk-your-omniroute-key` s API ključem kreiranim u OmniRoute-u.
- Polje `url` treba pokazivati na `/api/v1/vscode/{token}/chat/completions`.
- Polje `modelsUrl` treba pokazivati na `/api/v1/vscode/{token}/models`.
- Koristite uobičajeni tok `/v1` + Bearer zaglavlje kada klijent podržava prilagođena zaglavlja.
- Tokeni ugrađeni u URL su zamjensko rješenje za kompatibilnost i mogu se pojaviti u zapisnicima uređivača ili povijesti proxyja.

---

#### Kiro CLI (Amazon)

```bash
# Prijavite se na svoj AWS/Kiro račun:
kiro-cli login

# CLI koristi vlastitu autentifikaciju — OmniRoute nije potreban kao pozadinski sustav za sam Kiro CLI.
# Koristite kiro-cli zajedno s OmniRoute-om za ostale alate.
kiro-cli status
```

Za **Kiro IDE** desktop aplikaciju, koristite MITM krajnju točku koju OmniRoute
izlaže putem `/dashboard/cli-tools → Kiro`.

---

## 10. Interni OmniRoute CLI

Binarna datoteka `omniroute` pruža naredbe za upravljanje životnim ciklusom poslužitelja, postavljanje, dijagnostiku i upravljanje pružateljima. Ulazna točka: `bin/omniroute.mjs`.

```bash
omniroute                              # Pokreni poslužitelj (zadani priključak 20128)
omniroute setup                        # Interaktivni čarobnjak za postavljanje
omniroute doctor                       # Provjeri konfiguraciju, bazu podataka, priključke i izvršno okruženje
omniroute providers list               # Konfigurirane veze s pružateljima
omniroute providers test-all           # Testiraj svaku aktivnu vezu
omniroute reset-password               # Ponovno postavi administratorsku lozinku
omniroute logs                         # Kontinuirano prikazuj zapisnike zahtjeva
omniroute health                       # Detaljno stanje (prekidači, predmemorija, memorija)
omniroute --version                    # Ispiši verziju
omniroute --help                       # Prikaži sve naredbe
```

### Postavljanje i inicijalizacija

```bash
omniroute setup                        # Interaktivni čarobnjak za postavljanje
omniroute setup --non-interactive      # Način rada za CI/automatizaciju (čita varijable okruženja i zastavice)
omniroute setup --password '<value>'   # Izravno postavi administratorsku lozinku
omniroute setup --add-provider \
  --provider openai \
  --api-key '<value>' \
  --test-provider                      # Dodaj i testiraj pružatelja u jednom koraku
```

Prepoznate varijable okruženja za neinteraktivno postavljanje:

| Var                 | Namjena                                                               |
| ------------------- | --------------------------------------------------------------------- |
| `OMNIROUTE_API_KEY` | API ključ pružatelja (povezan s `--api-key` putem Commander `.env()`) |
| `DATA_DIR`          | Nadjačava OmniRoute direktorij podataka                               |

Svi ostali neinteraktivni ulazni podaci prosljeđuju se kao zastavice, a ne kao varijable okruženja:
`--password`, `--provider`, `--provider-name`, `--provider-base-url`, `--default-model`
(pogledajte prethodno navedene opcije za `omniroute setup`).

### Dijagnostika

```bash
omniroute doctor                       # Provjeri konfiguraciju, bazu podataka, priključke, izvršno okruženje, memoriju i dostupnost
omniroute doctor --json                # Strojno čitljiv JSON
omniroute doctor --no-liveness         # Preskoči HTTP provjeru stanja
omniroute doctor --host 0.0.0.0        # Nadjačaj glavno računalo za provjeru dostupnosti
omniroute doctor --liveness-url <url>  # Nadjačaj puni URL krajnje točke stanja
```

Naredba doctor izvodi sljedeće provjere: `Config`, `Database`, `Storage/encryption`,
`Port availability`, `Node runtime`, `Native binary` (better-sqlite3),
`Memory` i `Server liveness`. Završava s kodom različitim od nule ako bilo koja provjera ima status `fail`.

### Upravljanje pružateljima

```bash
omniroute providers available                       # Katalog OmniRoute pružatelja
omniroute providers available --search openai       # Filtriraj katalog prema ID-u/nazivu/pseudonimu/kategoriji
omniroute providers available --category api-key    # Filtriraj prema kategoriji (api-key, oauth, free, ...)
omniroute providers available --json                # Strojno čitljiv JSON

omniroute providers list                            # Konfigurirane veze s pružateljima
omniroute providers list --json

omniroute providers test <id|name>                  # Testiraj jednu konfiguriranu vezu
omniroute providers test-all                        # Testiraj svaku aktivnu vezu
omniroute providers validate                        # Strukturna provjera samo lokalnih podataka
omniroute providers add <provider> --credential-env PROVIDER_KEY
omniroute providers import ./providers.json --dry-run --json
omniroute providers auth <provider>                 # Postojeći OAuth tijek
omniroute providers edit <id|name> --default-model <model>
omniroute providers remove <id|name> --yes
```

Naredbe `providers add/import/auth/edit/remove` prvenstveno upotrebljavaju API te stoga rade s
aktivnim lokalnim ili udaljenim kontekstom. Za unos vjerodajnica treba upotrebljavati
`--credential-stdin` ili `--credential-env`; `--dry-run --json` izvješćuje samo
o redigiranom postojanju/obliku. `providers available` čita OmniRoute katalog;
`providers list/test/test-all/validate` zadržavaju svoje lokalno SQLite ponašanje i
ne zahtijevaju da poslužitelj bude pokrenut.

### Oporavak i ponovno postavljanje

```bash
omniroute reset-password                # Ponovno postavi administratorsku lozinku (također: omniroute-reset-password)
omniroute reset-encrypted-columns       # Prikaži upozorenje i probno izvođenje za ponovno postavljanje šifriranih vjerodajnica
omniroute reset-encrypted-columns --force  # Doista postavi šifrirane vjerodajnice u SQLiteu na null
```

### Izvoz vjerodajnica (⚠ postupajte oprezno)

```bash
omniroute auth export                                 # Prikaži upozorenje i zatraži potvrdu — bez pristupa bazi podataka
omniroute auth export --force                          # Izvezi DEŠIFRIRANE vjerodajnice SVIH veza na standardni izlaz kao JSON
omniroute auth export --force --id <id>                 # Izvezi samo odgovarajuću vezu
omniroute auth export --force --format env               # Ispiši retke OMNIROUTE_<PROVIDER>_<FIELD>=<value>
omniroute auth export --force --out creds.json           # Zapiši u datoteku (stvorenu s dopuštenjima 0600)
```

`auth export` radi **samo lokalno** (izravno čitanje SQLitea, bez HTTP rute) i namjerno ispisuje/zapisuje
vrijednosti `apiKey`/`accessToken`/`refreshToken`/`idToken` u obliku **običnog teksta** — to je značajka, a ne
pogreška. Bez `--force` ništa se ne čita iz baze podataka i ništa se ne dešifrira. Natpis upozorenja
uvijek se ispisuje na stderr prije ispisivanja bilo kakvog običnog teksta. Zahtijeva postavljanje varijable
`STORAGE_ENCRYPTION_KEY`. Polje koje se ne uspije dešifrirati (zastarjeli ključ, oštećeni šifrirani tekst) prijavljuje se kao
`<field>DecryptFailed: true` umjesto prekidanja cijelog izvoza ili otkrivanja temeljne pogreške.

### Ostale podnaredbe

One pretpostavljaju da je OmniRoute poslužitelj pokrenut, osim ako nije drukčije navedeno:

```bash
omniroute status                       # Sveobuhvatan status izvođenja
omniroute logs                         # Strujanje zapisnika zahtjeva (--json, --search, --follow)
omniroute config list                  # Prikaz konfiguriranih CLI alata

omniroute provider list                # Popis dostupnih pružatelja (alias za providers list)
omniroute provider add                 # Registracija OmniRoutea kao pružatelja u alatu
omniroute keys add | list | remove     # Upravljanje API ključevima
omniroute models [provider]            # Popis modela (--json, --search)
omniroute combo list | switch | create | delete

omniroute backup                       # Snimka konfiguracije i baze podataka
omniroute restore                      # Vraćanje iz prethodne snimke

omniroute health                       # Detaljno stanje (prekidači, predmemorija, memorija)
omniroute quota                        # Iskorištenost kvote pružatelja
omniroute cache                        # Status predmemorije
omniroute cache clear                  # Brisanje semantičke predmemorije i predmemorije potpisa

omniroute mcp status | restart         # Status / ponovno pokretanje MCP poslužitelja
omniroute a2a status | card            # Status A2A poslužitelja / kartica agenta

omniroute tunnel list | create | stop  # Upravljanje tunelima (cloudflare/tailscale/ngrok)
omniroute env show | get <k> | set <k> <v>  # Pregled / postavljanje varijabli okruženja (privremeno)

omniroute test                         # Brzi test povezivosti s pružateljem
omniroute update                       # Provjera ažuriranja
omniroute completion                   # Generiranje dovršavanja naredbi u ljusci
```

### Uobičajene zastavice

| Zastavica           | Opis                                                   |
| ------------------- | ------------------------------------------------------ |
| `--no-open`         | Ne otvaraj automatski preglednik pri pokretanju        |
| `--port <n>`        | Promijeni API priključak (zadano 20128)                |
| `--mcp`             | Pokreni kao MCP poslužitelj putem stdio (za IDE-ove)   |
| `--non-interactive` | CI način rada (bez upita; čita iz okruženja/zastavica) |
| `--json`            | Strojno čitljiv JSON izlaz (doctor, providers itd.)    |
| `--help`, `-h`      | Prikaži pomoć specifičnu za naredbu                    |
| `--version`, `-v`   | Ispiši instaliranu verziju                             |

---

## Dostupni API krajnji točki

| Krajnja točka              | Opis                               | Koristi se za                        |
| -------------------------- | ---------------------------------- | ------------------------------------ |
| `/v1/chat/completions`     | Standardni chat (svi pružatelji)   | Svi moderni alati                    |
| `/v1/responses`            | Responses API (OpenAI format)      | Codex, agentski tijekovi             |
| `/v1/completions`          | Naslijeđena tekstualna dovršavanja | Stariji alati koji koriste `prompt:` |
| `/v1/embeddings`           | Tekstualni ugrađeni vektori        | RAG, pretraživanje                   |
| `/v1/images/generations`   | Generiranje slika                  | GPT-Image, Flux, itd.                |
| `/v1/audio/speech`         | Pretvaranje teksta u govor         | ElevenLabs, OpenAI TTS               |
| `/v1/audio/transcriptions` | Pretvaranje govora u tekst         | Deepgram, AssemblyAI                 |

Primjeri spremni za lijepljenje s tokeniziranim OmniRoute URL-om:

```txt
Token example: sk-a3ab3c080beaee3a-69f4a4-070d71af

Standard OpenAI base: http://localhost:20128/v1
VS Code models: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/models
VS Code chat: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/chat/completions
VS Code responses: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/responses
Ollama tags: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/api/tags
Ollama chat: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/api/chat
```

---

## Rješavanje problema

| Pogreška                                                  | Uzrok                              | Rješenje                                                 |
| --------------------------------------------------------- | ---------------------------------- | -------------------------------------------------------- |
| `Connection refused`                                      | OmniRoute nije pokrenut            | `omniroute serve`                                        |
| `401 Unauthorized`                                        | Pogrešan API ključ                 | Provjerite u `/dashboard/api-manager`                    |
| `No combo configured`                                     | Nema aktivne kombinacije rutiranja | Postavite u `/dashboard/combos`                          |
| CLI prikazuje "not installed"                             | Binarna datoteka nije u PATH-u     | Provjerite `which <command>`                             |
| Nadzorna ploča prikazuje "not detected" nakon instalacije | Predmemorija je zastarjela         | Kliknite "⟳ Refresh detection" na nadzornoj ploči        |
| Stara poveznica `/dashboard/cli-tools`                    | Oznaka prije v3.8.6                | Automatski preusmjerena na `/dashboard/cli-code` (308)   |
| Stara poveznica `/dashboard/agents`                       | Oznaka prije v3.8.6                | Automatski preusmjerena na `/dashboard/acp-agents` (308) |