OmniRoute/docs/i18n/sk/docs/reference/CLI-TOOLS.md

CLI Tools — OmniRoute (Slovenčina)

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

---

Posledná aktualizácia: 2026-08-23

OmniRoute sa integruje s tromi kategóriami nástrojov CLI rozdelenými medzi tri vyhradené stránky ovládacieho panela:

Stránka	Trasa	Koncept	Počet
CLI kódy	/dashboard/cli-code	Nástroje na programovanie smerované na OmniRoute (Klient → CLI → OmniRoute → Poskytovateľ)	26
Agenti CLI	/dashboard/cli-agents	Autonómni agenti smerovaní na OmniRoute (rovnaký tok, širší rozsah)	10
Agenti ACP	/dashboard/acp-agents	Nástroje CLI, ktoré OmniRoute spúšťa ako backend cez stdio/ACP (opačný tok)	pozri register

Staršie trasy sa presmerujú pomocou 308: /dashboard/cli-tools → /dashboard/cli-code, /dashboard/agents → /dashboard/acp-agents.

---

Ako to funguje

CLI kódy / Agenti CLI (tok spotreby):
Claude / Codex / OpenCode / Cline / KiloCode / Continue / Hermes Agent / Goose / ...
           │
           ▼  (všetky smerujú na OmniRoute)
    http://YOUR_SERVER:20128/v1
           │
           ▼  (OmniRoute smeruje požiadavku na správneho poskytovateľa)
    Anthropic / OpenAI / Gemini / DeepSeek / Groq / Mistral / ...

Agenti ACP (opačný tok spúšťania):
    Požiadavka klienta → OmniRoute → spustí CLI cez stdio/ACP → odpoveď

Výhody:

• Jeden kľúč API na správu všetkých nástrojov
• Sledovanie nákladov všetkých nástrojov CLI v ovládacom paneli
• Prepínanie modelov bez nutnosti opätovne konfigurovať každý nástroj
• Funguje lokálne aj na vzdialených serveroch (VPS, Docker, Akamai, Cloudflare Tunnel)

---

Automatická konfigurácia pomocou setup-*

Konfiguráciu každého nástroja nemusíte zapisovať ručne. OmniRoute obsahuje príkaz setup-* pre každý podporovaný nástroj CLI, ktorý načíta aktuálny katalóg modelov zo spusteného OmniRoute (lokálneho alebo vzdialeného) a zapíše vlastnú konfiguráciu nástroja vo vašom počítači:

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

Každý z nich prijíma --remote <url> --api-key <key> (konfigurácia lokálneho nástroja pre vzdialený OmniRoute), --dry-run (náhľad bez zápisu) a --port. Nástroje bez automatického zisťovania modelov (Cline, Kilo, Roo, Goose, Aider, Qwen, 5dive) prijímajú --model <id> (a --yes pri neinteraktívnom spustení). setup-5dive je jediný postup, ktorý nezapisuje do $HOME: konfiguruje skupinu agentov 5dive zapísaním autentifikačného profilu vlastneného používateľom root na hostiteľovi skupiny, preto sa opätovne spustí cez sudo a nemá vlastný vzdialený režim. Ak chcete spustiť CLI so správne vloženými premennými prostredia a úplne bez zápisu konfigurácie, použite všeobecný spúšťač omniroute run <target> (claude, codex, aider, goose, opencode, qwen, gemini — ciele a aliasy pochádzajú zo súboru bin/cli/cli-manifest.mjs); staršie spúšťače jednotlivých nástrojov omniroute launch (Claude Code) a omniroute launch-codex (Codex) zostávajú dostupné. Gemini CLI je možné iba spúšťať: je cieľom príkazu omniroute run, ale nemá žiadny postup setup-*/configure.

Úplná referencia: hlavná tabuľka — čo jednotlivé príkazy zapisujú, všetky príznaky, lokálny a vzdialený režim a ktoré nástroje vyžadujú príponu /v1 — sa nachádza v dokumente Integrácie CLI.

Spúšťanie týchto príkazov v kontajneri

Príkaz setup-* vykonaný v kontajneri OmniRoute zapisuje do domovského adresára samotného kontajnera, ktorý žiadny nástroj CLI hostiteľa nečíta a ktorý po zániku kontajnera zmizne. OmniRoute to zistí a namiesto zápisu skončí s kódom 2 a zobrazí pokyny. Existujú dva podporované spôsoby ďalšieho postupu — nainštalovať CLI na hostiteľovi a pomocou omniroute connect ho pripojiť ku kontajneru alebo pripojiť konfiguračné adresáre pomocou bind mountu a nastaviť CLI_CONFIG_HOME (profil compose host). Každý príkaz setup-*, ako aj omniroute configure a omniroute config set, prijíma --allow-container-write, ak skutočne chcete konfigurovať nástroje CLI samotného kontajnera; OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE=true zabezpečuje to isté pre server. Pozrite si Sprievodca Dockerom → Konfigurácia nástrojov CLI hostiteľa.

Koncový bod na použitie konfigurácie v ovládacom paneli (POST /api/cli-tools/apply) uplatňuje rovnakú ochranu: v kontajneri zápis, ktorého cieľ nie je pripojený z hostiteľa pomocou bind mountu, odpovie stavom 422 s containerEphemeralTarget: true, bezpečným textom chyby a — pre nástroje s postupom pre hostiteľa (claude, codex, opencode, cline, kilo, continue) — hodnotou hostSetupCommand (napr. omniroute setup-opencode), ktorú treba namiesto toho spustiť na hostiteľovi; nič sa nezapíše. dryRun: true naďalej funguje v režime kontajnera a vráti vygenerovaný obsah + cieľovú cestu bez zásahu do disku, takže si môžete zobraziť náhľad v ovládacom paneli a konfiguráciu použiť na hostiteľovi. Toto správanie je zámerné a chránené pred regresiami testom tests/unit/api/cli-tools/apply-container-guard.test.ts — chybu 422 nikdy „neopravujte“ odstránením tejto ochrany.

---

Zdroj pravdy

Zjednotený katalóg sa nachádza v súbore src/shared/constants/cliTools.ts ako CLI_TOOLS: Record<string, CliCatalogEntry>.

Každá položka obsahuje tieto polia (definované v src/shared/schemas/cliCatalog.ts):

Pole	Typ	Popis
category	"code" | "agent"	Stránka, na ktorej sa nástroj zobrazuje
vendor	string	Pôvod nástroja („Anthropic“, „OSS (P. Gauthier)“)
acpSpawnable	boolean	Možno ho použiť aj ako agenta ACP (zobrazí sa odznak)
baseUrlSupport	"full" | "partial" | "none"	Úroveň podpory vlastného koncového bodu. "none" = zoznam nevyriešených úloh MITM
configType	"env" | "custom" | "guide" | "custom-builder" | "mitm"	Mechanizmus konfigurácie
id, name, color, description, docsUrl	štandardné	Základné zobrazované polia

Položky s baseUrlSupport: "none" sa na stránkach ovládacieho panela nezobrazujú — sú zaregistrované v zozname nevyriešených úloh MITM pre plán 11 (pozri _tasks/features-v3.8.6/refactorpages/_orchestration/_plan11-mitm-backlog.md).

Úrovne schopností (zaradené do katalógu × detegovateľné × konfigurovateľné × spustiteľné)

Nie každý nástroj zaradený do katalógu je detegovateľný, konfigurovateľný alebo spustiteľný. Každá úroveň má jeden deklaratívny zdroj a test odchýlok zabezpečuje ich vzájomný súlad:

Úroveň	Význam	Deklarované v
V katalógu	Zobrazuje sa v katalógu ovládacieho panela (názov, dodávateľ, dokumentácia, typ konfigurácie)	src/shared/constants/cliTools.ts (CLI_TOOLS)
Detegovateľné	Detekcia binárneho súboru/konfigurácie, kontroly stavu, cesty ku konfigurácii	src/shared/services/cliRuntime.ts (runtime katalóg CLI_TOOLS)
Konfigurovateľné	Podporované príkazom omniroute configure <cli> (existuje postup nastavenia)	bin/cli/cli-manifest.mjs (configure: true)
Spustiteľné	Podporované príkazom omniroute run <target> (definované vloženie premenných prostredia/argumentov)	bin/cli/cli-manifest.mjs (run: true)

bin/cli/cli-manifest.mjs je kanonický spustiteľný manifest pre rozhrania príkazov CLI: run, configure a generátory automatického dopĺňania príkazov shellu z neho odvodzujú zoznamy cieľov, rozpoznávanie aliasov (napríklad kilocode/kilo-code/kilo_cli → kilo) a zapojenie príznaku --model. Kontrola odchýlok tests/unit/cli/cli-manifest-drift.test.ts overuje, že manifest, runtime katalóg, katalóg používateľského rozhrania a všetky spotrebiteľské rozhrania zostávajú synchronizované — cieľ pridaný do jedného rozhrania bez pridania do ostatných spôsobí zlyhanie testovacej sady namiesto tichého vzniku odchýlky.

---

1. Katalóg CLI Code (26 nástrojov)

Všetky nástroje, ktoré sa zobrazujú v /dashboard/cli-code. Nástroje s baseUrlSupport: none sú namiesto vlastnej základnej URL prepojené cez MITM alebo sprievodcu manuálnym nastavením:

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

Nástroje s baseUrlSupport: "partial" zobrazujú na karte ovládacieho panela odznak „⚠ Čiastočná podpora základnej URL“.

2. Katalóg CLI agentov (10 nástrojov)

Autonómni agenti, ktorí sa zobrazujú v /dashboard/cli-agents:

id	názov	dodávateľ	podpora baseUrl	spustiteľný cez ACP
hermes-agent	Hermes Agent	Nous Research	úplná	false
openclaw	OpenClaw	OSS (P. Steinberger)	úplná	true
goose	Goose	Block / Linux Foundation	úplná	true
interpreter	Open Interpreter	OSS	úplná	true
warp	Warp AI	Warp Inc.	čiastočná	true
agent-deck	Agent Deck	asheshgoplani (OSS)	úplná	false
omp	Oh My Pi	OSS	úplná	true
letta	Letta CLI	Letta	úplná	false
prime-agent	Prime Agent	Prime Intellect (OSS)	úplná	false
5dive	5dive	OSS (5dive-ai)	úplná	false

---

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

Táto stránka (premenovaná z /dashboard/agents) zobrazuje CLI, ktoré môže OmniRoute spúšťať ako backendové vykonávacie enginy prostredníctvom protokolu stdio/ACP. Katalóg sa spravuje samostatne v src/lib/acp/registry.ts a nie je totožný s CLI_TOOLS.

---

4. Zoznam úloh MITM (nezobrazuje sa na paneli)

Nasledujúce CLI natívne nepodporujú vlastnú základnú URL adresu a nie sú uvedené na stránkach CLI Code ani CLI Agents. Sú kandidátmi na odchytávanie MITM v pláne 11:

CLI	Dôvod
windsurf	BYOK je obmedzené na vybrané modely Claude + firemnú URL/token
amp	Uzavretý ekosystém (Sourcegraph)
amazon-q / kiro-cli	Overenie AWS SSO, bez vlastnej URL adresy
cowork	Anthropic Desktop, bez konfigurovateľného koncového bodu

Úplný krížový odkaz nájdete v _tasks/features-v3.8.6/refactorpages/_orchestration/_plan11-mitm-backlog.md.

---

5. API na dávkovú detekciu

Detekcia všetkých nástrojov sa agreguje prostredníctvom jedného koncového bodu:

GET /api/cli-tools/all-statuses

• Overenie: requireCliToolsAuth(request) (rovnaké ako pri ostatných trasách /api/cli-tools/)
• Vracia: Record<toolId, ToolBatchStatus> (typ: src/shared/types/cliBatchStatus.ts)
• Stratégia: Promise.all pre všetky nástroje, časový limit 5 s na nástroj
• Vyrovnávacia pamäť: LRU v pamäti indexovaná podľa mtime konfiguračného súboru. Vyrovnávacia pamäť sa zneplatní pri zmene mtime. Obnoví sa pri reštarte servera.

Štruktúra odpovede pre jednotlivé nástroje:

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; // ošetrená hodnota, bez trasovania zásobníka
}

---

6. Obslužné mechanizmy nastavení pre nové nástroje

Nové nástroje s configType: "custom" majú vyhradené trasy API pre nastavenia:

Trasa	Nástroj
POST /api/cli-tools/forge-settings	ForgeCode (.forge.toml)
POST /api/cli-tools/jcode-settings	jcode (príznak --base-url)
POST /api/cli-tools/deepseek-tui-settings	DeepSeek TUI (OPENAI_BASE_URL, zastarané)
POST /api/cli-tools/codewhale-settings	CodeWhale (OPENAI_BASE_URL, primárna + zastaraná synchronizácia ~/.deepseek)
POST /api/cli-tools/smelt-settings	Smelt
POST /api/cli-tools/pi-settings	Programovací agent Pi
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 + vyhradený kľúč .env)

Všetky trasy používajú sanitizeErrorMessage() pre chybové odpovede (pevné pravidlo č. 12).

---

7. Architektúra stránok ovládacieho panela

CLI Code (/dashboard/cli-code)

• src/app/(dashboard)/dashboard/cli-code/page.tsx — serverový komponent
• src/app/(dashboard)/dashboard/cli-code/CliCodePageClient.tsx — klientska mriežka
• src/app/(dashboard)/dashboard/cli-code/[id]/page.tsx — stránka s podrobnosťami nástroja
• src/app/(dashboard)/dashboard/cli-code/components/ — 12 špecializovaných kariet nástrojov + ToolDetailClient.tsx

Agenti CLI (/dashboard/cli-agents)

• src/app/(dashboard)/dashboard/cli-agents/page.tsx — serverový komponent
• src/app/(dashboard)/dashboard/cli-agents/CliAgentsPageClient.tsx — klientska mriežka
• src/app/(dashboard)/dashboard/cli-agents/[id]/page.tsx — opätovne používa ToolDetailClient

Agenti ACP (/dashboard/acp-agents)

• src/app/(dashboard)/dashboard/acp-agents/page.tsx — serverový komponent (presunutý z agents/)

Zdieľané komponenty používateľského rozhrania (src/shared/components/cli/)

Súbor	Účel
CliToolCard.tsx	Inteligentná stavová karta (detekcia + konfigurácia + koncový bod)
CliConceptCard.tsx	Karta s vysvetlením konceptu pre každú stránku
CliComparisonCard.tsx	Trojstĺpcové porovnanie typov CLI
BaseUrlSelect.tsx	Rozbaľovacia ponuka koncového bodu (lokálny/cloudový/vlastný)
ApiKeySelect.tsx	Selektor kľúča API
ManualConfigModal.tsx	Modálne okno s kopírovateľným úryvkom konfigurácie

Zdieľaný hook (src/shared/hooks/cli/)

Súbor	Účel
useToolBatchStatuses.ts	Načítava /api/cli-tools/all-statuses, spravuje stav načítavania/obnovenia

---

8. i18n

Nové menné priestory pridané v pláne 14 F9:

Menný priestor	Účel
cliCommon	Zdieľané reťazce (štítky kariet, texty konceptov/porovnaní, štítky stránok detailov)
cliCode	Reťazce stránky CLI Code
cliAgents	Reťazce stránky CLI Agents
acpAgents	Reťazce stránky ACP Agents

K dispozícii sú kompletné preklady do PT-BR a EN. Ďalších 39 lokalizácií automaticky používa EN ako záložný jazyk prostredníctvom zlúčenia na úrovni menného priestoru v src/i18n/request.ts.

---

9. Rýchly štart

Krok 1 — Získajte API kľúč OmniRoute

1. Otvorte /dashboard/api-manager → Vytvoriť API kľúč
2. Pomenujte ho (napr. cli-tools) a vyberte všetky oprávnenia
3. Skopírujte kľúč — budete ho potrebovať pre každý nástroj CLI uvedený nižšie

Váš kľúč vyzerá takto: sk-xxxxxxxxxxxxxxxx-xxxxxxxxx

---

Krok 2 — Nainštalujte nástroje CLI

Všetky nástroje založené na npm vyžadujú Node.js 22.22.2+ alebo 24.x:

# 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žno spustiť cez `omniroute run gemini` → rozhranie /v1beta)
npm install -g @google/gemini-cli

# Aider
pip install aider-chat

# Smelt
cargo install smelt  # Založené na jazyku Rust

# Programovací agent Pi
# informácie o inštalácii nájdete na https://github.com/zechnerj/pi-coding-agent

# jcode
# informácie o inštalácii nájdete na https://github.com/1jehuang/jcode

---

Krok 3 — Konfigurácia prostredníctvom ovládacieho panela

1. Prejdite na http://localhost:20128/dashboard/cli-code
2. Nájdite svoj nástroj v mriežke
3. Kliknutím na kartu otvorte stránku s podrobnosťami o nástroji
4. Vyberte svoj API kľúč a základnú URL adresu
5. Kliknite na Použiť konfiguráciu alebo skopírujte úryvok manuálnej konfigurácie

---

Krok 4 — Nastavte globálne premenné prostredia

# Univerzálny koncový bod OmniRoute
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 načítava GOOGLE_GEMINI_BASE_URL z KOREŇOVEJ adresy (jeho SDK samo pridá /v1beta/...)
export GOOGLE_GEMINI_BASE_URL="http://localhost:20128"
export GEMINI_API_KEY="sk-your-omniroute-key"

V prípade vzdialeného servera nahraďte localhost:20128 IP adresou alebo doménou servera, napr. http://<your-server-ip>:20128.

---

Krok 4 — Nakonfigurujte jednotlivé nástroje

Claude Code

# Vytvorte ~/.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

Pre Claude Code použite koreňovú adresu zjednotenej brány Anthropic. Nepridávajte sem /v1.

Test: claude "say hello"

---

OpenAI Codex

Moderný Codex (v0.137+) načítava iba ~/.codex/config.toml — starý súbor config.yaml patrí k pôvodnému npm CLI a bez upozornenia sa ignoruje. API kľúč zostáva v premennej prostredia OMNIROUTE_API_KEY (env_key), nikdy nie v súbore:

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"

Úplná referencia (profily, wire_api, kontextové okná): CODEX-CLI-CONFIGURATION.md.

Test: codex "what is 2+2?"

---

OpenCode

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

Použite opencode run "your prompt" --model omniroute/claude-sonnet-4-5-thinking --variant high na odosielanie variantov s uvažovaním.

---

Cline (CLI alebo VS Code)

Režim CLI:

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

Režim VS Code: Nastavenia rozšírenia Cline → Poskytovateľ API: OpenAI Compatible → Základná URL: http://localhost:20128/v1

Prípadne použite ovládací panel OmniRoute → Nástroje CLI → Cline → Použiť konfiguráciu.

---

KiloCode (CLI alebo VS Code)

Režim CLI:

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

Nastavenia VS Code:

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

Prípadne použite ovládací panel OmniRoute → Nástroje CLI → KiloCode → Použiť konfiguráciu.

---

Continue (rozšírenie VS Code)

Upravte ~/.continue/config.yaml:

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

Po úprave reštartujte VS Code.

---

VS Code Insiders (chatLanguageModels.json)

Použite túto možnosť, keď je VS Code Insiders nakonfigurovaný pre modely s vlastným koncovým bodom a chcete, aby OmniRoute fungoval bez vlastného poľa hlavičky.

Odporúčané umiestnenie:

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

Príklad použitia tokenizovaného aliasu OmniRoute:

[
  {
    "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"
    }
  }
]

Poznámky:

• Nahraďte sk-your-omniroute-key kľúčom API vytvoreným v OmniRoute.
• Pole url by malo odkazovať na /api/v1/vscode/{token}/chat/completions.
• Pole modelsUrl by malo odkazovať na /api/v1/vscode/{token}/models.
• Ak klient podporuje vlastné hlavičky, uprednostnite štandardný postup s /v1 a hlavičkou Bearer.
• Tokeny vložené do URL sú záložným riešením na zabezpečenie kompatibility a môžu sa objaviť v protokoloch editora alebo histórii proxy servera.

---

Kiro CLI (Amazon)

# Prihláste sa do svojho účtu AWS/Kiro:
kiro-cli login

# CLI používa vlastné overovanie — samotný Kiro CLI nepotrebuje OmniRoute ako backend.
# Používajte kiro-cli spolu s OmniRoute pre ostatné nástroje.
kiro-cli status

V prípade desktopovej aplikácie Kiro IDE použite koncový bod MITM sprístupnený službou OmniRoute v časti /dashboard/cli-tools → Kiro.

---

10. Interné CLI OmniRoute

Binárny súbor omniroute poskytuje príkazy na správu životného cyklu servera, nastavenie, diagnostiku a správu poskytovateľov. Vstupný bod: bin/omniroute.mjs.

omniroute                              # Spustenie servera (predvolený port 20128)
omniroute setup                        # Interaktívny sprievodca nastavením
omniroute doctor                       # Kontrola konfigurácie, DB, portov a runtime prostredia
omniroute providers list               # Nakonfigurované pripojenia poskytovateľov
omniroute providers test-all           # Otestovanie každého aktívneho pripojenia
omniroute reset-password               # Obnovenie hesla správcu
omniroute logs                         # Priebežné zobrazovanie protokolov požiadaviek
omniroute health                       # Podrobný stav (ističe, vyrovnávacia pamäť, pamäť)
omniroute --version                    # Zobrazenie verzie
omniroute --help                       # Zobrazenie všetkých príkazov

Nastavenie a inicializácia

omniroute setup                        # Interaktívny sprievodca nastavením
omniroute setup --non-interactive      # Režim CI/automatizácie (číta premenné prostredia + príznaky)
omniroute setup --password '<value>'   # Priame nastavenie hesla správcu
omniroute setup --add-provider \
  --provider openai \
  --api-key '<value>' \
  --test-provider                      # Pridanie a otestovanie poskytovateľa v jednom kroku

Rozpoznávané premenné prostredia pre neinteraktívne nastavenie:

Premenná	Účel
OMNIROUTE_API_KEY	Kľúč API poskytovateľa (prepojený s --api-key cez Commander .env())
DATA_DIR	Prepísanie dátového adresára OmniRoute

Všetky ostatné neinteraktívne vstupy sa odovzdávajú ako príznaky, nie ako premenné prostredia: --password, --provider, --provider-name, --provider-base-url, --default-model (pozrite si možnosti príkazu omniroute setup vyššie).

Diagnostika

omniroute doctor                       # Kontrola konfigurácie, DB, portov, runtime prostredia, pamäte a aktivity
omniroute doctor --json                # Strojovo čitateľný JSON
omniroute doctor --no-liveness         # Preskočenie kontroly stavu cez HTTP
omniroute doctor --host 0.0.0.0        # Prepísanie hostiteľa kontroly aktivity
omniroute doctor --liveness-url <url>  # Prepísanie úplnej URL koncového bodu stavu

Príkaz doctor vykonáva tieto kontroly: Config, Database, Storage/encryption, Port availability, Node runtime, Native binary (better-sqlite3), Memory a Server liveness. Skončí s nenulovým návratovým kódom, ak má ktorákoľvek kontrola stav fail.

Správa poskytovateľov

omniroute providers available                       # Katalóg poskytovateľov OmniRoute
omniroute providers available --search openai       # Filtrovanie katalógu podľa ID/názvu/aliasu/kategórie
omniroute providers available --category api-key    # Filtrovanie podľa kategórie (api-key, oauth, free, ...)
omniroute providers available --json                # Strojovo čitateľný JSON

omniroute providers list                            # Nakonfigurované pripojenia poskytovateľov
omniroute providers list --json

omniroute providers test <id|name>                  # Otestovanie jedného nakonfigurovaného pripojenia
omniroute providers test-all                        # Otestovanie každého aktívneho pripojenia
omniroute providers validate                        # Iba lokálna štrukturálna validácia
omniroute providers add <provider> --credential-env PROVIDER_KEY
omniroute providers import ./providers.json --dry-run --json
omniroute providers auth <provider>                 # Existujúci tok OAuth
omniroute providers edit <id|name> --default-model <model>
omniroute providers remove <id|name> --yes

Príkazy providers add/import/auth/edit/remove používajú primárne API, a preto fungujú voči aktívnemu lokálnemu alebo vzdialenému kontextu. Na zadanie prihlasovacích údajov použite --credential-stdin alebo --credential-env; --dry-run --json hlási iba redigovanú prítomnosť/štruktúru. Príkaz providers available číta katalóg OmniRoute; providers list/test/test-all/validate si zachovávajú svoje lokálne správanie SQLite a nevyžadujú spustený server.

Obnova a resetovanie

omniroute reset-password                # Obnovenie hesla správcu (tiež: omniroute-reset-password)
omniroute reset-encrypted-columns       # Zobrazenie upozornenia + skúšobné spustenie resetovania šifrovaných prihlasovacích údajov
omniroute reset-encrypted-columns --force  # Skutočné nastavenie šifrovaných prihlasovacích údajov v SQLite na hodnotu null

Export prihlasovacích údajov (⚠ zaobchádzajte s nimi opatrne)

omniroute auth export                                 # Zobrazenie upozornenia + vyžiadanie potvrdenia — bez prístupu k DB
omniroute auth export --force                          # Export DEŠIFROVANÝCH prihlasovacích údajov VŠETKÝCH pripojení do stdout vo formáte JSON
omniroute auth export --force --id <id>                 # Export iba zodpovedajúceho pripojenia
omniroute auth export --force --format env               # Výstup riadkov OMNIROUTE_<PROVIDER>_<FIELD>=<value>
omniroute auth export --force --out creds.json           # Zápis do súboru (vytvoreného s oprávneniami 0600)

Príkaz auth export funguje iba lokálne (priame čítanie SQLite, bez trasy HTTP) a zámerne zobrazuje/zapisuje hodnoty apiKey/accessToken/refreshToken/idToken ako obyčajný text — ide o funkciu, nie o chybu. Bez príznaku --force sa z databázy nič nečíta ani nedešifruje. Pred vypísaním akéhokoľvek obyčajného textu sa na stderr vždy zobrazí upozornenie. Vyžaduje nastavenie premennej STORAGE_ENCRYPTION_KEY. Pole, ktoré sa nepodarí dešifrovať (neaktuálny kľúč, poškodený šifrovaný text), sa nahlási ako <field>DecryptFailed: true namiesto prerušenia celého exportu alebo zverejnenia súvisiacej chyby.

Ďalšie podpríkazy

Tieto príkazy predpokladajú spustený server OmniRoute, pokiaľ nie je uvedené inak:

omniroute status                       # Komplexný stav behu
omniroute logs                         # Streamovanie protokolov požiadaviek (--json, --search, --follow)
omniroute config show                  # Zobrazenie aktuálnej konfigurácie

omniroute provider list                # Zoznam dostupných poskytovateľov (alias pre providers list)
omniroute provider add                 # Registrácia OmniRoute ako poskytovateľa v nástroji
omniroute keys add | list | remove     # Správa API kľúčov
omniroute models [provider]            # Zoznam modelov (--json, --search)
omniroute combo list | switch | create | delete

omniroute backup                       # Snímka konfigurácie a databázy
omniroute restore                      # Obnovenie z predchádzajúcej snímky

omniroute health                       # Podrobný stav (ističe, vyrovnávacia pamäť, pamäť)
omniroute quota                        # Využitie kvóty poskytovateľa
omniroute cache                        # Stav vyrovnávacej pamäte
omniroute cache clear                  # Vymazanie sémantickej vyrovnávacej pamäte a vyrovnávacej pamäte podpisov

omniroute mcp status | restart         # Stav/reštart servera MCP
omniroute a2a status | card            # Stav servera A2A/karta agenta

omniroute tunnel list | create | stop  # Správa tunelov (cloudflare/tailscale/ngrok)
omniroute env show | get <k> | set <k> <v>  # Kontrola/nastavenie premenných prostredia (dočasné)

omniroute test                         # Základný test pripojenia k poskytovateľovi
omniroute update                       # Kontrola aktualizácií
omniroute completion                   # Generovanie dopĺňania príkazov shellu

Bežné príznaky

Príznak	Popis
--no-open	Neotvárať automaticky prehliadač pri spustení
--port <n>	Prepísať port API (predvolene 20128)
--mcp	Spustiť ako server MCP cez stdio (pre IDE)
--non-interactive	Režim CI (bez výziev; číta z prostredia/príznakov)
--json	Strojovo čitateľný výstup JSON (doctor, providers atď.)
--help, -h	Zobraziť pomoc pre konkrétny príkaz
--version, -v	Vypísať nainštalovanú verziu

---

Dostupné koncové body API

Koncový bod	Popis	Použitie
/v1/chat/completions	Štandardný chat (všetci poskytovatelia)	Všetky moderné nástroje
/v1/responses	Responses API (formát OpenAI)	Codex, agentné pracovné postupy
/v1/completions	Staršie textové dokončovanie	Staršie nástroje používajúce prompt:
/v1/embeddings	Textové vnorenia	RAG, vyhľadávanie
/v1/images/generations	Generovanie obrázkov	GPT-Image, Flux atď.
/v1/audio/speech	Prevod textu na reč	ElevenLabs, OpenAI TTS
/v1/audio/transcriptions	Prevod reči na text	Deepgram, AssemblyAI

Príklady pripravené na vloženie s tokenizovanou URL adresou OmniRoute:

Príklad tokenu: sk-a3ab3c080beaee3a-69f4a4-070d71af

Štandardná základná adresa OpenAI: http://localhost:20128/v1
Modely VS Code: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/models
Chat VS Code: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/chat/completions
Odpovede VS Code: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/responses
Značky Ollama: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/api/tags
Chat Ollama: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/api/chat

---

Riešenie problémov

Chyba	Príčina	Riešenie
Connection refused	OmniRoute nie je spustený	omniroute serve
401 Unauthorized	Nesprávny kľúč API	Skontrolujte ho v /dashboard/api-manager
No combo configured	Žiadna aktívna kombinácia smerovania	Nastavte ju v /dashboard/combos
CLI zobrazuje „not installed“	Binárny súbor nie je v PATH	Skontrolujte pomocou which <command>
Ovládací panel po inštalácii zobrazuje „not detected“	Neaktuálna vyrovnávacia pamäť	Kliknite na „⟳ Refresh detection“ na ovládacom paneli
Starý odkaz /dashboard/cli-tools	Záložka spred verzie v3.8.6	Automaticky presmerované na /dashboard/cli-code (308)
Starý odkaz /dashboard/agents	Záložka spred verzie v3.8.6	Automaticky presmerované na /dashboard/acp-agents (308)