# CLI Tools — OmniRoute (Igbo) 🌐 **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) · 🇮🇹 [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) --- Emelitere ikpeazụ: 2026-08-23 OmniRoute na-ejikọta ya na ụdị ngwa CLI atọ e kesara n’ofe ibe dashboard atọ pụrụ iche: | Ibe | Ụzọ | Echiche | Ọnụọgụ | | ----------------------- | ----------------------- | ----------------------------------------------------------------------------------------------- | ------------ | | **Koodu CLI** | `/dashboard/cli-code` | Ngwa ide koodu ị na-atụnye na OmniRoute (Client → CLI → OmniRoute → Provider) | 26 | | **Ndị nnọchi anya CLI** | `/dashboard/cli-agents` | Ndị nnọchi anya kwụụrụ onwe ha ị na-atụnye na OmniRoute (otu usoro ahụ, mana oke ya sara mbara) | 10 | | **Ndị nnọchi anya ACP** | `/dashboard/acp-agents` | CLI ndị OmniRoute na-ebido dị ka backend site na stdio/ACP (usoro ntụgharị azụ) | lee registry | Ụzọ ochie na-eji 308 atụgharị: `/dashboard/cli-tools` → `/dashboard/cli-code`, `/dashboard/agents` → `/dashboard/acp-agents`. --- ## Otu O Si Arụ Ọrụ ``` Koodu CLI / Ndị nnọchi anya CLI (usoro ojiji): Claude / Codex / OpenCode / Cline / KiloCode / Continue / Hermes Agent / Goose / ... │ ▼ (ha niile na-atụ aka na OmniRoute) http://YOUR_SERVER:20128/v1 │ ▼ (OmniRoute na-eziga arịrịọ ahụ na provider kwesịrị ekwesị) Anthropic / OpenAI / Gemini / DeepSeek / Groq / Mistral / ... Ndị nnọchi anya ACP (usoro mbido ntụgharị azụ): Arịrịọ client → OmniRoute → na-ebido CLI site na stdio/ACP → nzaghachi ``` **Uru:** - Otu API key iji jikwaa ngwa niile - Nsochi ụgwọ maka CLI niile n’ime dashboard - Ịgbanwe model n’ebughị ụzọ hazie ngwa ọ bụla ọzọ - Na-arụ ọrụ na kọmputa mpaghara nakwa na sava dị anya (VPS, Docker, Akamai, Cloudflare Tunnel) --- ## Jiri `setup-*` hazie ya na-akpaghị aka Ịkwesịghị iji aka dee config nke ngwa ọ bụla. OmniRoute nwere iwu `setup-*` maka CLI ọ bụla a na-akwado, nke na-agụ katalọgụ model **dị ndụ** site na OmniRoute na-agba ọrụ (nke mpaghara ma ọ bụ nke dị anya), wee dee config nke ngwa ahụ n’onwe ya na kọmputa gị: ```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 ``` Nke ọ bụla na-anabata `--remote --api-key ` (iji hazie ngwa mpaghara ka ọ rụọ ọrụ megide OmniRoute dị anya), `--dry-run` (iji hụ ihe a ga-eme n’edeghị ihe ọ bụla), na `--port`. Ngwa ndị na-enweghị nchọpụta model na-akpaghị aka (Cline, Kilo, Roo, Goose, Aider, Qwen, 5dive) na-eji `--model ` (yana `--yes` maka ịgba ọsọ na-enweghị mkparịta ụka). `setup-5dive` bụ naanị usoro nhazi na-adịghị ede ihe n’okpuru `$HOME`: ọ na-ahazi otu ìgwè ndị nnọchi anya 5dive site n’ide profaịlụ auth nke root nwe na host nke ìgwè ahụ, ya mere ọ na-eji `sudo` malitegharịa onwe ya ma ọ nweghị mode dị anya nke ya. Iji malite CLI ka etinyere env kwesịrị ekwesị n’edeghị config ọ bụla ma ọlị, jiri launcher izugbe `omniroute run ` (claude, codex, aider, goose, opencode, qwen, gemini — targets na aliases sitere na `bin/cli/cli-manifest.mjs`); launchers ochie akọwapụtara maka ngwa ọ bụla, `omniroute launch` (Claude Code) na `omniroute launch-codex` (Codex), ka dịkwa. Gemini CLI bụ naanị maka mmalite: ọ bụ target nke `omniroute run`, mana o nweghị usoro `setup-*`/`configure`. > **Nrụtụaka zuru ezu:** tebụl ukwu ahụ — ihe iwu ọ bụla na-ede, flag ọ bụla, > nke mpaghara megide nke dị anya, na ngwa ndị chọrọ suffix `/v1` — dị na > **[Njikọ CLI](../guides/CLI-INTEGRATIONS.md)**. ### Ịgba ndị a n’ime container Iwu `setup-*` e gburu n’ime container OmniRoute na-ede ihe n’ime home nke container ahụ n’onwe ya, nke CLI ọ bụla dị na host anaghị agụ ma nke na-apụ mgbe container ahụ kwụsịrị ịdị. OmniRoute na-achọpụta nke ahụ wee jiri `2` kwụsị, yana ntuziaka, kama ide ihe. E nwere ụzọ abụọ a na-akwado iji gaa n’ihu — wụnye CLI na host wee jiri `omniroute connect` jikọọ na container ahụ, ma ọ bụ jiri bind-mount tinye config dirs ma tọọ `CLI_CONFIG_HOME` (profaịlụ compose `host`). Iwu `setup-*` ọ bụla, tinyere `omniroute configure` na `omniroute config set`, na-anabata `--allow-container-write` mgbe ihe i bu n’obi n’ezie bụ ịhazi CLI nke container ahụ n’onwe ya; `OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE=true` na-emekwa otu ihe ahụ maka sava. Lee [Ntuziaka Docker → Ịhazị ngwa CLI nke host](../guides/DOCKER_GUIDE.md#configuring-host-cli-tools-when-omniroute-runs-in-docker). **Apply endpoint** nke dashboard (`POST /api/cli-tools/apply`) na-amanye otu nchedo ahụ: n’ime container, ide ihe nke target ya na-esiteghị na host site na bind-mount na-aza **`422`** yana `containerEphemeralTarget: true`, ederede njehie nchekwa na — maka ngwa ndị nwere usoro host (claude, codex, opencode, cline, kilo, continue) — `hostSetupCommand` (dịka `omniroute setup-opencode`) nke a ga-agba na host kama ime ya ebe ahụ; ọ dịghị ihe a na-ede. `dryRun: true` ka na-arụ ọrụ na mode container ma na-eweghachi nlele e kpuchiri ozi nzuzo + ụzọ target n’emetụghị disk aka. Ọdịnaya nlele abụghị nhazi nwere credential nke a ga-edepụta ma ọ bụ bubata. Tinye ya na host site n’iji tool/base URL/API key/model inputs mbụ, ma ọ bụ jiri iwu nhazi nke dị n’akụkụ host e gosiri. Lee [Nchekwa nhazi CLI](../security/CLI-CONFIGURATION.md) maka header nlele na nkwekọrịta arịrịọ. Omume a bụ nke e mere n’ebumnobi ma regression guard na-echekwa ya site na `tests/unit/api/cli-tools/apply-container-guard.test.ts` — emela mgbe ọ bụla ka ị “dozie” 422 site n’iwepụ guard ahụ. --- ## Isi Eziokwu Katalọgụ ejikọtara ọnụ dị na `src/shared/constants/cliTools.ts` dịka `CLI_TOOLS: Record`. Ndenye ọ bụla nwere mpaghara ndị a (akọwapụtara na `src/shared/schemas/cliCatalog.ts`): | Mpaghara | Ụdị | Nkọwa | | ----------------------------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------- | | `category` | `"code" \| "agent"` | Peeji nke ngwa ahụ na-apụta na ya | | `vendor` | `string` | Ebe ngwa ahụ si bịa ("Anthropic", "OSS (P. Gauthier)") | | `acpSpawnable` | `boolean` | A pụkwara iji ya dịka ACP Agent (a na-egosi baajị) | | `baseUrlSupport` | `"full" \| "partial" \| "none"` | Ọkwa nkwado endpoint ahaziri iche. `"none"` = ndepụta ọrụ MITM | | `configType` | `"env" \| "custom" \| "guide" \| "custom-builder" \| "mitm"` | Usoro nhazi | | `id`, `name`, `color`, `description`, `docsUrl` | ọkọlọtọ | Mpaghara ndị bụ isi eji egosi ihe | A **naghị egosi** ndenye ndị nwere `baseUrlSupport: "none"` na peeji dashboard — edebanyere ha na ndepụta ọrụ MITM maka atụmatụ 11 (lee `_tasks/features-v3.8.6/refactorpages/_orchestration/_plan11-mitm-backlog.md`). ### Ọkwa ike (edepụtara na katalọgụ × achọpụtakwara × ahazikwara × enwere ike ịmalite) Ọ bụghị ngwa niile edepụtara na katalọgụ ka enwere ike ịchọpụta, ịhazi, ma ọ bụ ịmalite. Ọkwa ọ bụla nwere otu isi mmalite na-ekwupụta ya, ule ndapụkwa na-eme ka ha nọgide kwekọọ: | Ọkwa | Ihe ọ pụtara | Ebe e kwupụtara ya | | ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------ | | **Dị na katalọgụ** | Na-apụta na katalọgụ dashboard (aha, vendor, docs, ụdị nhazi) | `src/shared/constants/cliTools.ts` (`CLI_TOOLS`) | | **Achọpụtakwara** | Nchọpụta binary/config, nyocha ahụike, ụzọ config | `src/shared/services/cliRuntime.ts` (katalọgụ runtime `CLI_TOOLS`) | | **Ahazikwara** | `omniroute configure ` na-akwado ya (usoro ntọlite dị) | `bin/cli/cli-manifest.mjs` (`configure: true`) | | **A pụrụ ịmalite** | `omniroute run ` na-akwado ya (akọwapụtara ntinye env/args) | `bin/cli/cli-manifest.mjs` (`run: true`) | `bin/cli/cli-manifest.mjs` bụ manifest arụmọrụ bụ isi maka mpaghara iwu CLI: `run`, `configure` na ndị na-emepụta shell-completion niile na-enweta ndepụta target ha, mkpebi alias (dịka ọmụmaatụ `kilocode`/`kilo-code`/`kilo_cli` → `kilo`) na njikọ flag `--model` site na ya. Ihe nche ndapụ `tests/unit/cli/cli-manifest-drift.test.ts` na-akwado na manifest ahụ, katalọgụ runtime, katalọgụ UI na mpaghara ọ bụla na-eji ha nọgide na-emekọrịta — target agbakwunyere na otu mpaghara na-enweghị ndị ọzọ na-eme ka test suite daa kama ikwe ka ndapụ mee nwayọ n’amaghị ama. --- ## 1. Katalọgụ Koodu CLI (ngwaọrụ 26) Ngwaọrụ niile pụtara na `/dashboard/cli-code`. Ndị nwere `baseUrlSupport: none` na-eji MITM ma ọ bụ ntuziaka aka arụ ọrụ kama iji URL ntọala ahaziri iche: | 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 | Ngwaọrụ nwere `baseUrlSupport: "partial"` na-egosi baajị "⚠ URL ntọala ezughị ezu" na kaadị dashboard. --- ## 2. Katalọgụ Ndị Agent CLI (ngwaọrụ 10) Ndị agent na-arụ ọrụ n'onwe ha nke na-apụta na `/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. Ndị Agent ACP (/dashboard/acp-agents) Ihu a (nke a gbanwere aha ya site na `/dashboard/agents`) na-egosi CLI ndị OmniRoute nwere ike **ịmalite** dị ka injin mmebe backend site na protocol stdio/ACP. A na-elekọta katalọgụ ahụ iche na `src/lib/acp/registry.ts`, ọ **bụghịkwa** otu ihe ahụ dị ka `CLI_TOOLS`. --- ## 4. Ọrụ MITM Ndị Ka Fọdụrụ (anaghị egosi ya na dashboard) CLI ndị na-esonụ anaghị akwado URL isi ahaziri iche n'onwe ha, e **depụtaghịkwa ha** na ibe CLI Code ma ọ bụ CLI Agents. Ha bụ ndị a na-atụle maka mgbochi MITM na atụmatụ 11: | CLI | Ihe kpatara ya | | ------------------- | ---------------------------------------------------------------- | | windsurf | BYOK nwere oke naanị na ụdị Claude ahọpụtara + URL/token ụlọ ọrụ | | amp | Usoro mechiri emechi (Sourcegraph) | | amazon-q / kiro-cli | Nnyocha njirimara AWS SSO, enweghị URL ahaziri iche | | cowork | Anthropic Desktop, enweghị endpoint enwere ike ịhazi | Lee `_tasks/features-v3.8.6/refactorpages/_orchestration/_plan11-mitm-backlog.md` maka ntụaka njikọta zuru ezu. --- ## 5. API Nchọpụta N'ìgwè A na-achịkọta nchọpụta ngwaọrụ niile site n'otu endpoint: **`GET /api/cli-tools/all-statuses`** - Nnyocha njirimara: `requireCliToolsAuth(request)` (otu ihe ahụ dị ka route `/api/cli-tools/` ndị ọzọ) - Na-eweghachi: `Record` (ụdị: `src/shared/types/cliBatchStatus.ts`) - Atụmatụ: `Promise.all` n'elu ngwaọrụ niile, timeout nke 5s maka ngwaọrụ ọ bụla - Cache: LRU dị na memory nke config file `mtime` na-edepụta. A na-eme ka cache ghara ịdị irè mgbe mtime gbanwere. A na-emegharị ya mgbe server maliteghachiri. Ọdịdị response maka ngwaọrụ ọ bụla: ```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; // emeziri ka ọ dị nchebe, enweghị stack trace } ``` --- ## 6. Ndị Na-ahụ Maka Ntọala Maka Ngwa Ọrụ Ọhụrụ Ngwa ọrụ ọhụrụ nwere `configType: "custom"` nwere ụzọ API ntọala pụrụ iche: | Ụzọ | Ngwa ọrụ | | ------------------------------------------- | ------------------------------------------------------------------------------ | | `POST /api/cli-tools/forge-settings` | ForgeCode (.forge.toml) | | `POST /api/cli-tools/jcode-settings` | jcode (akara `--base-url`) | | `POST /api/cli-tools/deepseek-tui-settings` | DeepSeek TUI (OPENAI_BASE_URL, nke ochie) | | `POST /api/cli-tools/codewhale-settings` | CodeWhale (OPENAI_BASE_URL, nke bụ isi + mmekọrịta nke ochie na `~/.deepseek`) | | `POST /api/cli-tools/smelt-settings` | Smelt | | `POST /api/cli-tools/pi-settings` | Onye nnọchi anya Pi maka ide koodu | | `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` + igodo `.env` pụrụ iche) | Ụzọ niile na-eji `sanitizeErrorMessage()` maka nzaghachi njehie (Iwu Siri Ike #12). --- ## 7. Nhazi Ibe Dashboard ### Koodu CLI (`/dashboard/cli-code`) - `src/app/(dashboard)/dashboard/cli-code/page.tsx` — kọmpọnenti sava - `src/app/(dashboard)/dashboard/cli-code/CliCodePageClient.tsx` — grid nke klaịent - `src/app/(dashboard)/dashboard/cli-code/[id]/page.tsx` — ibe nkọwa ngwa ọrụ - `src/app/(dashboard)/dashboard/cli-code/components/` — kaadị ngwa ọrụ pụrụ iche 12 + `ToolDetailClient.tsx` ### Ndị Nnọchi Anya CLI (`/dashboard/cli-agents`) - `src/app/(dashboard)/dashboard/cli-agents/page.tsx` — kọmpọnenti sava - `src/app/(dashboard)/dashboard/cli-agents/CliAgentsPageClient.tsx` — grid nke klaịent - `src/app/(dashboard)/dashboard/cli-agents/[id]/page.tsx` — na-eji `ToolDetailClient` ọzọ ### Ndị Nnọchi Anya ACP (`/dashboard/acp-agents`) - `src/app/(dashboard)/dashboard/acp-agents/page.tsx` — kọmpọnenti sava (e si na `agents/` bugharịa ya) ### Kọmpọnenti UI Ndị A Na-ejikọta Ọnụ (`src/shared/components/cli/`) | Faịlụ | Ebumnuche | | ----------------------- | -------------------------------------------------------- | | `CliToolCard.tsx` | Kaadị ọkwa nwere ọgụgụ isi (nchọpụta + nhazi + endpoint) | | `CliConceptCard.tsx` | Kaadị nkọwa echiche maka ibe ọ bụla | | `CliComparisonCard.tsx` | Ntụnyere kọlụm atọ n'etiti ụdị CLI | | `BaseUrlSelect.tsx` | Ndepụta nhọrọ endpoint (Mpaghara/Cloud/Nke ahaziri) | | `ApiKeySelect.tsx` | Ihe nhọrọ igodo API | | `ManualConfigModal.tsx` | Modal nke ibe nhazi enwere ike idetuo | ### Hook A Na-ejikọta Ọnụ (`src/shared/hooks/cli/`) | Faịlụ | Ebumnuche | | ------------------------- | ------------------------------------------------------------------------ | | `useToolBatchStatuses.ts` | Na-enweta `/api/cli-tools/all-statuses`, na-ejikwa ọnọdụ nbudata/mmelite | ## 8. i18n Agbakwunyere namespace ọhụrụ na plan 14 F9: | Namespace | Ebumnuche | | ----------- | ------------------------------------------------------------------------------- | | `cliCommon` | Ederede a na-ekekọrịta (akara kaadị, ederede echiche/ntụnyere, akara ibe nkọwa) | | `cliCode` | Ederede ibe CLI Code | | `cliAgents` | Ederede ibe CLI Agents | | `acpAgents` | Ederede ibe ACP Agents | E nyere ntụgharị PT-BR na EN zuru ezu. Locale 39 ndị ọzọ na-alaghachi na EN na-akpaghị aka site na njikọta n'ogo namespace dị na `src/i18n/request.ts`. --- ## 9. Mmalite Ngwa Ngwa ### Nzọụkwụ 1 — Nweta Igodo API OmniRoute 1. Mepee `/dashboard/api-manager` → **Mepụta Igodo API** 2. Nye ya aha (dịka ọmụmaatụ `cli-tools`) ma họrọ ikike niile 3. Detuo igodo ahụ — ị ga-achọ ya maka CLI ọ bụla dị n'okpuru > Igodo gị ga-adị ka nke a: `sk-xxxxxxxxxxxxxxxx-xxxxxxxxx` --- ### Nzọụkwụ 2 — Wụnye Ngwaọrụ CLI Ngwaọrụ niile dabere na npm chọrọ Node.js 22.22.2+ ma ọ bụ 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 (enwere ike ịmalite ya site na `omniroute run gemini` → /v1beta surface) npm install -g @google/gemini-cli # Aider pip install aider-chat # Smelt cargo install smelt # Dabere na Rust # Pi coding agent # lee https://github.com/zechnerj/pi-coding-agent maka ntinye # jcode # lee https://github.com/1jehuang/jcode maka ntinye ``` --- ### Nzọụkwụ 3 — Hazie site na Dashboard 1. Gaa na `http://localhost:20128/dashboard/cli-code` 2. Chọta ngwaọrụ gị na grid 3. Pịa kaadị ahụ iji mepee ibe nkọwa ngwaọrụ 4. Họrọ igodo API gị na URL ntọala 5. Pịa **Tinye Nhazi** ma ọ bụ detuo obere ederede nhazi aka --- ### Nzọụkwụ 4 — Tọọ Mgbanwe Gburugburuwuru nke G gburugburu Ebe Ọrụ ```bash # Ebe njedebe zuru ụwa ọnụ nke 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-agụ GOOGLE_GEMINI_BASE_URL na ROOT (SDK ya na-agbakwụnye /v1beta/... n'onwe ya) export GOOGLE_GEMINI_BASE_URL="http://localhost:20128" export GEMINI_API_KEY="sk-your-omniroute-key" ``` > Maka **sava dị anya**, jiri IP ma ọ bụ domain sava dochie `localhost:20128`, > dịka ọmụmaatụ `http://:20128`. --- ### Nzọụkwụ 4 — Hazie Ngwaọrụ Ọ Bụla #### Claude Code ```bash # Mepụta ~/.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 ``` Jiri mgbọrọgwụ ọnụ ụzọ Anthropic jikọtara ọnụ maka Claude Code. Etinyela `/v1` ebe a. **Nnwale:** `claude "say hello"` --- #### OpenAI Codex Codex ọgbara ọhụrụ (v0.137+) na-agụ naanị `~/.codex/config.toml` — `config.yaml` ochie bụ nke CLI npm nke mgbe ochie, a na-eleghara ya anya n'enweghị ọkwa. Igodo API na-anọgide na mgbanwe gburugburu ebe ọrụ `OMNIROUTE_API_KEY` (`env_key`), ọ dịghị mgbe ọ ga-adị n'ime faịlụ ahụ: ```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" ``` Ntụaka zuru ezu (profaịlụ, `wire_api`, windo ọnọdụ): [CODEX-CLI-CONFIGURATION.md](../guides/CODEX-CLI-CONFIGURATION.md). **Nnwale:** `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 ``` **Nnwale:** `opencode` > Jiri `opencode run "your prompt" --model omniroute/claude-sonnet-4-5-thinking --variant high` > iji zipụ ụdị ndị na-eche echiche. --- #### Cline (CLI ma ọ bụ VS Code) **Ụdị CLI:** ```bash mkdir -p ~/.cline/data && cat > ~/.cline/data/globalState.json << EOF { "apiProvider": "openai", "openAiBaseUrl": "http://localhost:20128/v1", "openAiApiKey": "sk-your-omniroute-key" } EOF ``` **Ụdị VS Code:** Ntọala mgbakwunye Cline → Onye na-enye API: `OpenAI Compatible` → URL ntọala: `http://localhost:20128/v1` Ma ọ bụ jiri dashboard OmniRoute → **Ngwaọrụ CLI → Cline → Tinye Nhazi**. --- #### KiloCode (CLI ma ọ bụ VS Code) **Ụdị CLI:** ```bash kilocode --api-base http://localhost:20128/v1 --api-key sk-your-omniroute-key ``` **Ntọala VS Code:** ```json { "kilo-code.openAiBaseUrl": "http://localhost:20128/v1", "kilo-code.apiKey": "sk-your-omniroute-key" } ``` Ma ọ bụ jiri dashboard OmniRoute → **Ngwaọrụ CLI → KiloCode → Tinye Nhazi**. --- #### Continue (Mgbakwunye VS Code) Dezie `~/.continue/config.yaml`: ```yaml models: - name: OmniRoute provider: openai model: auto apiBase: http://localhost:20128/v1 apiKey: sk-your-omniroute-key default: true ``` Malitegharịa VS Code mgbe idezichara ya. --- #### VS Code Insiders (`chatLanguageModels.json`) Jiri nke a mgbe ahaziri VS Code Insiders maka model ebe njedebe ahaziri iche, ma ịchọrọ ka OmniRoute rụọ ọrụ na-enweghị oghere header ahaziri iche. **Ebe akwadoro:** - Linux: `~/.config/Code - Insiders/User/chatLanguageModels.json` - Windows: `%APPDATA%/Code - Insiders/User/chatLanguageModels.json` **Ọmụmaatụ iji utuaha OmniRoute e tinyere token:** ```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" } } ] ``` **Ihe ndetu:** - Jiri igodo API e mepụtara na OmniRoute dochie `sk-your-omniroute-key`. - Oghere `url` kwesịrị ịtụ aka na `/api/v1/vscode/{token}/chat/completions`. - Oghere `modelsUrl` kwesịrị ịtụ aka na `/api/v1/vscode/{token}/models`. - Họrọ usoro nkịtị `/v1` + nkụnyeisi Bearer mgbe ngwa ahịa ahụ na-akwado nkụnyeisi ahaziri iche. - Token ndị etinyere n'ime URL bụ ụzọ ndabere maka ndakọrịta, ha nwekwara ike ịpụta na ndekọ editọ ma ọ bụ akụkọ proxy. --- #### Kiro CLI (Amazon) ```bash # Banye na akaụntụ AWS/Kiro gị: kiro-cli login # CLI na-eji usoro njirimara nke ya — OmniRoute adịghị mkpa dịka backend maka Kiro CLI n'onwe ya. # Jiri kiro-cli yana OmniRoute maka ngwaọrụ ndị ọzọ. kiro-cli status ``` Maka ngwa desktọọpụ **Kiro IDE**, jiri endpoint MITM nke OmniRoute na-ewepụta n'okpuru `/dashboard/cli-tools → Kiro`. --- ## 10. OmniRoute CLI nke Ime Faịlụ binary `omniroute` na-enye iwu maka usoro ndụ sava, nhazi, nyocha nsogbu, na njikwa ndị na-eweta ọrụ. Ebe mbido: `bin/omniroute.mjs`. ```bash omniroute # Bido sava (ọdụ ụgbọ ndabara bụ 20128) omniroute setup # Ọkachamara nhazi mmekọrịta omniroute doctor # Lelee nhazi, DB, ọdụ ụgbọ, na gburugburu ọrụ omniroute providers list # Njikọ ndị na-eweta ọrụ ahaziri omniroute providers test-all # Nwalee njikọ ọ bụla na-arụ ọrụ omniroute reset-password # Tọgharịa okwuntughe onye nchịkwa omniroute logs # Zipụta ndekọ arịrịọ ozugbo omniroute health # Nkọwa ahụike zuru ezu (breakers, cache, ebe nchekwa) omniroute --version # Bipụta ụdị omniroute --help # Gosi iwu niile ``` ### Nhazi & Mbido ```bash omniroute setup # Ọkachamara nhazi mmekọrịta omniroute setup --non-interactive # Ọnọdụ CI/akpaaka (na-agụ env vars + flags) omniroute setup --password '' # Tọọ okwuntughe onye nchịkwa ozugbo omniroute setup --add-provider \ --provider openai \ --api-key '' \ --test-provider # Tinye ma nwalee onye na-eweta ọrụ n'otu oge ``` Mgbanwe gburugburu ndị a ka a na-amata maka nhazi na-enweghị mmekọrịta: | Var | Ebumnuche | | ------------------- | ------------------------------------------------------------------------------------ | | `OMNIROUTE_API_KEY` | Igodo API onye na-eweta ọrụ (ejikọtara ya na `--api-key` site na Commander `.env()`) | | `DATA_DIR` | Dochie ndekọ data OmniRoute | A na-enyefe ntinye ndị ọzọ niile na-enweghị mmekọrịta dịka flags, ọ bụghị mgbanwe gburugburu: `--password`, `--provider`, `--provider-name`, `--provider-base-url`, `--default-model` (lee nhọrọ `omniroute setup` ndị dị n'elu). ### Nchọpụta Nsogbu ```bash omniroute doctor # Lelee nhazi, DB, ọdụ ụgbọ, gburugburu ọrụ, ebe nchekwa, na ịdị ndụ omniroute doctor --json # JSON igwe nwere ike ịgụ omniroute doctor --no-liveness # Mafere nyocha ahụike HTTP omniroute doctor --host 0.0.0.0 # Dochie host ịdị ndụ omniroute doctor --liveness-url # Dochie URL zuru ezu nke endpoint ahụike ``` Doctor na-eme nyocha ndị a: `Config`, `Database`, `Storage/encryption`, `Port availability`, `Node runtime`, `Native binary` (better-sqlite3), `Memory`, na `Server liveness`. Ọ na-apụ na koodu na-abụghị efu ma ọ bụrụ na nyocha ọ bụla bụ `fail`. ### Njikwa Ndị Na-eweta Ọrụ ```bash omniroute providers available # Katalọgụ ndị na-eweta ọrụ OmniRoute omniroute providers available --search openai # Nyocha katalọgụ site na id/aha/aha ọzọ/ụdị omniroute providers available --category api-key # Nyocha site na ụdị (api-key, oauth, free, ...) omniroute providers available --json # JSON igwe nwere ike ịgụ omniroute providers list # Njikọ ndị na-eweta ọrụ ahaziri omniroute providers list --json omniroute providers test # Nwalee otu njikọ ahaziri omniroute providers test-all # Nwalee njikọ ọ bụla na-arụ ọrụ omniroute providers validate # Nnyocha nhazi nke naanị mpaghara omniroute providers add --credential-env PROVIDER_KEY omniroute providers import ./providers.json --dry-run --json omniroute providers auth # Usoro OAuth dị adị omniroute providers edit --default-model omniroute providers remove --yes ``` `providers add/import/auth/edit/remove` na-ebute API ụzọ, ya mere ha na-arụ ọrụ megide ọnọdụ mpaghara ma ọ bụ nke dị anya na-arụ ọrụ ugbu a. Ntinye nzere kwesịrị iji `--credential-stdin` ma ọ bụ `--credential-env`; `--dry-run --json` na-akọ naanị ọnụnọ/usoro e zoro ụfọdụ akụkụ ya. `providers available` na-agụ katalọgụ OmniRoute; `providers list/test/test-all/validate` na-ejigide omume SQLite mpaghara ha ma ha achọghị ka sava na-arụ ọrụ. Maka node ahaziri iche kwekọrọ na OpenAI ma ọ bụ Anthropic, jikọta nzere na ID node nke `omniroute nodes add` weghachiri, site n'iji `omniroute keys add "$NODE_ID" --stdin`. Nke a chọrọ sava na-arụ ọrụ na nkwenye njikwa maka ọnọdụ na-arụ ọrụ ugbu a. CLI na-eji `POST /api/providers`, nke na-enyocha node ahụ ma detuo ntọala endpoint ya n'ime njikọ ahụ. Node na-adịghị, ọdịda ikike, ma ọ bụ sava na-adịghị adị na-eweghachi njehie na-enweghị ịmepụta nzere mpaghara ọzọ. `nodes add --base-url` na-ahazi endpoint node ahụ; ọ dị iche na adreesị sava dị na `OMNIROUTE_BASE_URL`. Maka faịlụ OpenAPI, jiri `omniroute openapi dump --format json --out ./openapi.json`; `--output` zuru ụwa ọnụ na-ahọrọ usoro ngosipụta CLI, ọ bụghị aha faịlụ ebe a ga-edebe ya. ### Mweghachi & Ntọgharị ```bash omniroute reset-password # Tọgharịa okwuntughe onye nchịkwa (ọzọkwa: omniroute-reset-password) omniroute reset-encrypted-columns # Gosi ịdọ aka ná ntị + nnwale efu maka ntọgharị nzere ezoro ezo omniroute reset-encrypted-columns --force # Tọọ nzere ezoro ezo n'ezie ka ọ bụrụ null na SQLite ``` ### Mbupụ Nzere (⚠ jiri nlezianya mee ihe) ```bash omniroute auth export # Gosi ịdọ aka ná ntị + ọnụ ụzọ nkwenye — enweghị ohere DB omniroute auth export --force # Bupụ nzere E KEPỤRỤ EZORO EZO nke njikọ NIILE gaa stdout dịka JSON omniroute auth export --force --id # Bupụ naanị njikọ kwekọrọ omniroute auth export --force --format env # Wepụta ahịrị OMNIROUTE__= omniroute auth export --force --out creds.json # Dee ya na faịlụ (eji ikike 0600 mepụta ya) ``` `auth export` bụ **naanị-mpụga-netwọkụ** (ọ na-agụ SQLite ozugbo, enweghị HTTP route) ma a kpachapụrụ anya mee ka ọ bipụta/dee ụkpụrụ **ederede nkịtị** `apiKey`/`accessToken`/`refreshToken`/`idToken` — nke ahụ bụ atụmatụ ahụ, ọ bụghị ntụpọ. Ọ dịghị ihe a na-agụ site na ọdụ data, ọ dịghịkwa ihe a na-ewepụ izo ya ezo, na-enweghị `--force`. Ọkọlọtọ ịdọ aka ná ntị na-apụta mgbe niile na stderr tupu e wepụta ederede nkịtị ọ bụla. Ọ chọrọ ka edobe `STORAGE_ENCRYPTION_KEY`. A na-akọ ubi nke e nweghị ike iwepụ izo ya ezo (igodo ochie, ciphertext mebiri emebi) dị ka `DecryptFailed: true` kama ịkwụsị mbupụ ahụ dum ma ọ bụ ikpughe njehie dị n'okpuru ya. ### Iwu nta ndị ọzọ Ndị a na-ewere na sava OmniRoute na-arụ ọrụ, belụsọ ebe e kwuru ihe ọzọ: ```bash omniroute status # Ọnọdụ oge-ngagharị zuru ezu omniroute logs # Zipụta ndekọ arịrịọ n'aga n'ihu (--json, --search, --follow) omniroute config list # Gosipụta ngwa CLI ahaziri omniroute provider list # Depụta ndị na-eweta ọrụ dị (aha ọzọ nke providers list) omniroute provider add # Debanye OmniRoute dị ka onye na-eweta ọrụ na ngwa omniroute keys add | list | remove # Jikwaa igodo API omniroute models [provider] # Depụta ụdịdị (--json, --search) omniroute combo list | switch | create | delete omniroute backup # Mepụta snapshot nke nhazi + DB omniroute restore # Weghachite site na snapshot gara aga omniroute health # Nkọwa ahụike zuru ezu (breakers, cache, ebe nchekwa) omniroute quota # Ojiji oke nke onye na-eweta ọrụ omniroute cache # Ọnọdụ cache omniroute cache clear # Hichapụ cache semantic + signature omniroute mcp status | restart # Ọnọdụ sava MCP / ịmalitegharị omniroute a2a status | card # Ọnọdụ sava A2A / kaadị agent omniroute tunnel list | create | stop # Jikwaa tunnel (cloudflare/tailscale/ngrok) omniroute env show | get | set # Nyochaa / tọọ env vars (nwa oge) omniroute test # Nnwale ngwa ngwa nke njikọ onye na-eweta ọrụ omniroute update # Lelee mmelite omniroute completion # Mepụta mmeju shell ``` ### Ọkọlọtọ ndị a na-ejikarị | Ọkọlọtọ | Nkọwa | | ------------------- | --------------------------------------------------------- | | `--no-open` | Emeghela ihe nchọgharị na-akpaghị aka mgbe a malitere | | `--port ` | Gbanwee port API (ndabara bụ 20128) | | `--mcp` | Gbaa ọsọ dị ka sava MCP site na stdio (maka IDEs) | | `--non-interactive` | Ọnọdụ CI (enweghị ajụjụ; na-agụ site na env/ọkọlọtọ) | | `--json` | Mmepụta JSON igwe nwere ike ịgụ (doctor, providers, wdg.) | | `--help`, `-h` | Gosi enyemaka metụtara iwu ahụ | | `--version`, `-v` | Bipụta ụdị arụnyere | --- ## Ebe Njedebe API Ndị Dị | Ebe njedebe | Nkọwa | Ihe e ji ya eme | | -------------------------- | ----------------------------------------- | --------------------------------- | | `/v1/chat/completions` | Mkparịta ụka ọkọlọtọ (ndị na-eweta niile) | Ngwaọrụ ọgbara ọhụrụ niile | | `/v1/responses` | API nzaghachi (usoro OpenAI) | Codex, usoro ọrụ ndị nnọchiteanya | | `/v1/completions` | Mmecha ederede usoro ochie | Ngwaọrụ ochie na-eji `prompt:` | | `/v1/embeddings` | Ntinye ederede | RAG, ọchụchọ | | `/v1/images/generations` | Mepụta onyonyo | GPT-Image, Flux, wdg. | | `/v1/audio/speech` | Ederede gaa n'okwu | ElevenLabs, OpenAI TTS | | `/v1/audio/transcriptions` | Okwu gaa na ederede | Deepgram, AssemblyAI | Ọmụmaatụ dị njikere mado nke nwere URL OmniRoute e tinyere token: ```txt Ọmụmaatụ token: sk-a3ab3c080beaee3a-69f4a4-070d71af Ntọala OpenAI ọkọlọtọ: http://localhost:20128/v1 Ụdị VS Code: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/models Mkparịta ụka VS Code: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/chat/completions Nzaghachi VS Code: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/responses Mkpado Ollama: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/api/tags Mkparịta ụka Ollama: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/api/chat ``` --- ## Nchọpụta na Ndozi Nsogbu | Njehie | Ihe kpatara ya | Ndozi | | ------------------------------------------------------ | ---------------------------------------- | ------------------------------------------------------------- | | `Connection refused` | OmniRoute anaghị arụ ọrụ | `omniroute serve` | | `401 Unauthorized` | Igodo API ezighi ezi | Lelee na `/dashboard/api-manager` | | `No combo configured` | Enweghị ngwakọta ntụgharị ụzọ na-arụ ọrụ | Hazie ya na `/dashboard/combos` | | CLI na-egosi "awụnyeghị ya" | Faịlụ binary adịghị na PATH | Lelee `which ` | | Dashboard na-egosi "achọpụtaghị ya" mgbe awụnyesịrị ya | Cache emebeghị ọhụrụ | Pịa "⟳ Mee nchọpụta ọhụrụ" na dashboard | | Njikọ ochie `/dashboard/cli-tools` | Bookmark tupu v3.8.6 | A na-ebuga ya na-akpaghị aka na `/dashboard/cli-code` (308) | | Njikọ ochie `/dashboard/agents` | Bookmark tupu v3.8.6 | A na-ebuga ya na-akpaghị aka na `/dashboard/acp-agents` (308) | ## Jiri OmniRoute CLI jikwaa amụma inference-key Jiri ọnọdụ njikwa ekwenyere njirimara (lee [Ọnọdụ Ime Ebe Dị Anya](../guides/REMOTE-MODE.md)) iji ID ya nyochaa ma ọ bụ melite igodo inference dị adị: ```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` bụ aha ọzọ maka `--model-access-mode all`. Mmelite ahụ na-ehichapụ ndepụta ụdị ndị enyere ohere. Ọ na-echekwa scopes, iwu njikọ, ụdị ndị egbochiri, oke ọnụego na oke ụgwọ, yabụ njikwa ndị ọzọ ahụ ka nwere ike ịjụ arịrịọ. Itinye `--allowed-models ""` kpọmkwem na-ahọrọkwa `all`; jikọta ya na `--model-access-mode restricted` iji debe igodo amachibidoro nke na-enweghị ụdị enyere ohere. Ndepụta na-adịghị efu nke e ji rikoma kewaa na-ahọrọ `restricted` ma ọ bụrụ na akọwaghị ya kpọmkwem. A ga-ajụ ngwakọta `all` na ndepụta ikike na-adịghị efu nke na-emegiderịta onwe ya tupu izipu arịrịọ. `--rate-limit 30` na-edobe ọnụ ọgụgụ arịrịọ kwa nkeji ma na-echekwa iwu maka windo oge ndị ọzọ. `--max-cost 5` na-eme ka oke USD kwa ụbọchị rụọ ọrụ n'agbanweghị oke kwa izu; `--max-cost 0` na-ewepụ oke kwa ụbọchị ma na-echekwa mgbanyụ/mgbanye oke ojiji dị ugbu a na oke kwa izu. Akụkụ amụma ndị a hapụrụ agaghị agbanwe. Mgbanwe ọnụego na-ebu ụzọ gụọ amụma dị ugbu a; zere idezi n'otu oge na nhazi rate-limit nke otu igodo ahụ. Iwu amụma na-eji `GET`/`PATCH /api/keys/{id}` e ji nkwenye njirimara chebe ma na-asọpụrụ ọnọdụ na-arụ ọrụ na nhọrọ zuru ụwa ọnụ `--api-key`. Mmepụta JSON nwere naanị akụkụ amụma, na-enweghị igodo echekwara ma ọ bụ ngosipụta ya e kpuchiri ekpuchi. Nzere e mere naanị maka inference enweghị ike inye ikike maka mgbanwe njikwa. Nzaghachi 401/403 chọrọ ka enyocha nzere njikwa na ọnọdụ; ọ naghị egosi na token CLI mpaghara ma ọ bụ salt dara ada. Lee [Token CLI](../security/CLI_TOKEN.md) maka nkwekọrịta nkwenye njirimara mpaghara dị iche.