# CLI Tools — OmniRoute (नेपाली)

🌐 **Languages:** 🇺🇸 [English](../../../../reference/CLI-TOOLS.md) · 🇪🇹 [am](../../../am/docs/reference/CLI-TOOLS.md) · 🇸🇦 [ar](../../../ar/docs/reference/CLI-TOOLS.md) · 🇦🇿 [az](../../../az/docs/reference/CLI-TOOLS.md) · 🇧🇬 [bg](../../../bg/docs/reference/CLI-TOOLS.md) · 🇧🇩 [bn](../../../bn/docs/reference/CLI-TOOLS.md) · 🇧🇦 [bs](../../../bs/docs/reference/CLI-TOOLS.md) · 🇨🇿 [cs](../../../cs/docs/reference/CLI-TOOLS.md) · 🇩🇰 [da](../../../da/docs/reference/CLI-TOOLS.md) · 🇩🇪 [de](../../../de/docs/reference/CLI-TOOLS.md) · 🇬🇷 [el](../../../el/docs/reference/CLI-TOOLS.md) · 🇪🇸 [es](../../../es/docs/reference/CLI-TOOLS.md) · 🇪🇪 [et](../../../et/docs/reference/CLI-TOOLS.md) · 🇮🇷 [fa](../../../fa/docs/reference/CLI-TOOLS.md) · 🇫🇮 [fi](../../../fi/docs/reference/CLI-TOOLS.md) · 🇫🇷 [fr](../../../fr/docs/reference/CLI-TOOLS.md) · 🇮🇪 [ga](../../../ga/docs/reference/CLI-TOOLS.md) · 🇮🇳 [gu](../../../gu/docs/reference/CLI-TOOLS.md) · 🇳🇬 [ha](../../../ha/docs/reference/CLI-TOOLS.md) · 🇮🇱 [he](../../../he/docs/reference/CLI-TOOLS.md) · 🇮🇳 [hi](../../../hi/docs/reference/CLI-TOOLS.md) · 🇭🇷 [hr](../../../hr/docs/reference/CLI-TOOLS.md) · 🇭🇺 [hu](../../../hu/docs/reference/CLI-TOOLS.md) · 🇦🇲 [hy](../../../hy/docs/reference/CLI-TOOLS.md) · 🇮🇩 [id](../../../id/docs/reference/CLI-TOOLS.md) · 🇳🇬 [ig](../../../ig/docs/reference/CLI-TOOLS.md) · 🇮🇹 [it](../../../it/docs/reference/CLI-TOOLS.md) · 🇯🇵 [ja](../../../ja/docs/reference/CLI-TOOLS.md) · 🇬🇪 [ka](../../../ka/docs/reference/CLI-TOOLS.md) · 🇰🇭 [km](../../../km/docs/reference/CLI-TOOLS.md) · 🇮🇳 [kn](../../../kn/docs/reference/CLI-TOOLS.md) · 🇰🇷 [ko](../../../ko/docs/reference/CLI-TOOLS.md) · 🇱🇹 [lt](../../../lt/docs/reference/CLI-TOOLS.md) · 🇱🇻 [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) · 🇳🇱 [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)

---

अन्तिम अद्यावधिक: 2026-08-23

OmniRoute तीनवटा समर्पित ड्यासबोर्ड पृष्ठहरूमा विभाजित CLI उपकरणका तीन श्रेणीसँग एकीकृत हुन्छ:

| पृष्ठ          | रुट                     | अवधारणा                                                                                      | सङ्ख्या              |
| -------------- | ----------------------- | -------------------------------------------------------------------------------------------- | -------------------- |
| **CLI Code's** | `/dashboard/cli-code`   | तपाईंले OmniRoute तर्फ निर्देशित गर्ने कोडिङ उपकरणहरू (क्लाइन्ट → CLI → OmniRoute → प्रदायक) | 26                   |
| **CLI Agents** | `/dashboard/cli-agents` | तपाईंले OmniRoute तर्फ निर्देशित गर्ने स्वायत्त एजेन्टहरू (उही प्रवाह, अझ व्यापक दायरा)      | 10                   |
| **ACP Agents** | `/dashboard/acp-agents` | OmniRoute ले stdio/ACP मार्फत ब्याकएन्डका रूपमा सुरु गर्ने CLI हरू (विपरीत प्रवाह)           | रजिस्ट्री हेर्नुहोस् |

पुराना रुटहरू 308 मार्फत रिडाइरेक्ट हुन्छन्: `/dashboard/cli-tools` → `/dashboard/cli-code`, `/dashboard/agents` → `/dashboard/acp-agents`.

---

## यसले कसरी काम गर्छ

```
CLI Code's / CLI Agents (उपभोग प्रवाह):
Claude / Codex / OpenCode / Cline / KiloCode / Continue / Hermes Agent / Goose / ...
           │
           ▼  (सबै OmniRoute तर्फ निर्देशित हुन्छन्)
    http://YOUR_SERVER:20128/v1
           │
           ▼  (OmniRoute ले सही प्रदायकतर्फ रुट गर्छ)
    Anthropic / OpenAI / Gemini / DeepSeek / Groq / Mistral / ...

ACP Agents (उल्टो सुरु गर्ने प्रवाह):
    क्लाइन्ट अनुरोध → OmniRoute → stdio/ACP मार्फत CLI सुरु गर्छ → प्रतिक्रिया
```

**फाइदाहरू:**

- सबै उपकरण व्यवस्थापन गर्न एउटै API कुञ्जी
- ड्यासबोर्डमा सबै CLI को लागत ट्र्याकिङ
- प्रत्येक उपकरण पुनः कन्फिगर नगरी मोडेल परिवर्तन
- स्थानीय र रिमोट सर्भरहरूमा काम गर्छ (VPS, Docker, Akamai, Cloudflare Tunnel)

---

## `setup-*` मार्फत स्वतः-कन्फिगर गर्नुहोस्

तपाईंले प्रत्येक उपकरणको कन्फिगरेसन हातले लेख्नु पर्दैन। OmniRoute ले समर्थित प्रत्येक CLI को लागि `setup-*` कमाण्ड प्रदान गर्दछ जसले चलिरहेको OmniRoute (स्थानीय वा रिमोट) बाट **प्रत्यक्ष** मोडेल क्याटलग पढ्छ र तपाईंको मेसिनमा उपकरणको आफ्नै कन्फिगरेसन लेख्छ:

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

प्रत्येकले `--remote <url> --api-key <key>` (रिमोट OmniRoute विरुद्ध स्थानीय उपकरण कन्फिगर गर्नुहोस्), `--dry-run` (नलेखिकन पूर्वावलोकन), र `--port` स्वीकार गर्दछ। मोडेल स्वतः-खोज नभएका उपकरणहरू (Cline, Kilo, Roo, Goose, Aider, Qwen, 5dive) ले `--model <id>` (र गैर-अन्तरक्रियात्मक रनका लागि `--yes`) लिन्छन्। `setup-5dive` एक मात्र रेसिपी हो जसले `$HOME` अन्तर्गत लेख्दैन: यसले फ्लीट होस्टमा रुट-स्वामित्वको प्रमाणीकरण प्रोफाइल लेखेर 5dive एजेन्ट फ्लीट कन्फिगर गर्दछ, त्यसैले यसले `sudo` मार्फत पुन: कार्यान्वयन गर्दछ र यसको आफ्नै रिमोट मोड छैन। सही env इन्जेक्ट गरी र कुनै कन्फिगरेसन नलेखिकन CLI सुरु गर्न, जेनेरिक `omniroute run <target>` लन्चर प्रयोग गर्नुहोस् (claude, codex, aider, goose, opencode, qwen, gemini — लक्ष्यहरू र उपनामहरू `bin/cli/cli-manifest.mjs` बाट आउँछन्); लिगेसी प्रति-उपकरण लन्चरहरू `omniroute launch` (Claude Code) र `omniroute launch-codex` (Codex) उपलब्ध छन्। Gemini CLI लन्च-मात्र हो: यो `omniroute run` लक्ष्य हो तर यसमा कुनै `setup-*`/`configure` रेसिपी छैन।

> **पूर्ण सन्दर्भ:** मास्टर तालिका — प्रत्येक कमाण्डले के लेख्छ, प्रत्येक फ्ल्याग, स्थानीय बनाम रिमोट, र कुन उपकरणहरूलाई `/v1` प्रत्यय चाहिन्छ — **[CLI Integrations](../guides/CLI-INTEGRATIONS.md)** मा छ।

### यीलाई कन्टेनर भित्र चलाउँदै

OmniRoute कन्टेनर भित्र चलाइएको `setup-*` कमाण्डले कन्टेनरको आफ्नै होममा लेख्छ, जुन कुनै होस्ट CLI ले पढ्दैन र जुन कन्टेनरसँगै हराउँछ। OmniRoute ले त्यो पत्ता लगाउँछ र लेख्नुको सट्टा निर्देशन सहित `2` मा बाहिरिन्छ। अगाडि बढ्ने दुई समर्थित तरिकाहरू — होस्टमा CLI स्थापना गर्नुहोस् र कन्टेनरमा `omniroute connect` गर्नुहोस्, वा कन्फिगरेसन डाइरेक्टरीहरूलाई बाइन्ड-माउन्ट गर्नुहोस् र `CLI_CONFIG_HOME` (कम्पोज `host` प्रोफाइल) सेट गर्नुहोस्। प्रत्येक `setup-*` कमाण्ड, साथै `omniroute configure` र `omniroute config set`, ले `--allow-container-write` स्वीकार गर्दछ जब कन्टेनरको आफ्नै CLIs कन्फिगर गर्नु तपाईंको वास्तविक अर्थ हो; `OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE=true` ले सर्भरको लागि पनि त्यही गर्छ। हेर्नुहोस् [Docker Guide → Configuring host CLI tools](../guides/DOCKER_GUIDE.md#configuring-host-cli-tools-when-omniroute-runs-in-docker)।

ड्यासबोर्डको **apply endpoint** (`POST /api/cli-tools/apply`) ले उही गार्ड लागू गर्दछ: कन्टेनरमा, होस्टबाट बाइन्ड-माउन्ट नगरिएको लक्ष्यमा लेख्दा `containerEphemeralTarget: true` सहित **`422`** जवाफ दिन्छ, सुरक्षित त्रुटि पाठ र — होस्ट रेसिपी भएका उपकरणहरू (claude, codex, opencode, cline, kilo, continue) को लागि — होस्टमा चलाउनको लागि `hostSetupCommand` (जस्तै `omniroute setup-opencode`); केही पनि लेखिँदैन। `dryRun: true` कन्टेनर मोडमा काम गरिरहन्छ र डिस्क नछोइकन एक सम्पादित पूर्वावलोकन + लक्ष्य मार्ग फर्काउँछ। पूर्वावलोकन सामग्री प्रतिलिपि गर्न वा आयात गर्नका लागि प्रमाण-सहितको कन्फिगरेसन होइन। होस्टमा मूल उपकरण/आधार URL/API कुञ्जी/मोडेल इनपुटहरूसँग लागू गर्नुहोस्, वा संकेत गरिएको होस्ट-साइड सेटअप कमाण्ड प्रयोग गर्नुहोस्। पूर्वावलोकन हेडर र अनुरोध सम्झौताको लागि [CLI configuration security](../security/CLI-CONFIGURATION.md) हेर्नुहोस्। यो व्यवहार जानाजानी हो र `tests/unit/api/cli-tools/apply-container-guard.test.ts` द्वारा रिग्रेसन-सुरक्षित छ — गार्ड हटाएर 422 लाई कहिल्यै "ठीक" नगर्नुहोस्।

---

## सत्यको स्रोत

एकीकृत क्याटलग `src/shared/constants/cliTools.ts` मा `CLI_TOOLS: Record<string, CliCatalogEntry>` को रूपमा अवस्थित छ।

प्रत्येक प्रविष्टिमा यी फिल्डहरू हुन्छन् (`src/shared/schemas/cliCatalog.ts` मा परिभाषित):

| फिल्ड                                           | प्रकार                                                       | विवरण                                                                  |
| ----------------------------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------- |
| `category`                                      | `"code" \| "agent"`                                          | उपकरण कुन पृष्ठमा देखिन्छ                                              |
| `vendor`                                        | `string`                                                     | उपकरणको उत्पत्ति ("Anthropic", "OSS (P. Gauthier)")                    |
| `acpSpawnable`                                  | `boolean`                                                    | ACP Agent का रूपमा पनि प्रयोग गर्न मिल्ने (ब्याज देखाइन्छ)             |
| `baseUrlSupport`                                | `"full" \| "partial" \| "none"`                              | अनुकूलन गरिएको एन्डपोइन्ट समर्थन स्तर। `"none"` = MITM बाँकी कार्यसूची |
| `configType`                                    | `"env" \| "custom" \| "guide" \| "custom-builder" \| "mitm"` | कन्फिगरेसन संयन्त्र                                                    |
| `id`, `name`, `color`, `description`, `docsUrl` | मानक                                                         | मुख्य प्रदर्शन फिल्डहरू                                                |

`baseUrlSupport: "none"` भएका प्रविष्टिहरू ड्यासबोर्ड पृष्ठहरूमा **देखाइँदैनन्** — तिनीहरू योजना 11 को MITM बाँकी कार्यसूचीमा दर्ता गरिएका छन् (`_tasks/features-v3.8.6/refactorpages/_orchestration/_plan11-mitm-backlog.md` हेर्नुहोस्)।

### क्षमता तहहरू (क्याटलगमा समावेश × पत्ता लगाउन मिल्ने × कन्फिगर गर्न मिल्ने × सुरु गर्न मिल्ने)

क्याटलगमा समावेश भएका सबै उपकरण पत्ता लगाउन, कन्फिगर गर्न वा सुरु गर्न मिल्ने हुँदैनन्। प्रत्येक तहको
एउटा घोषणात्मक स्रोत हुन्छ, र विचलन परीक्षणले तिनलाई समक्रमित राख्छ:

| तह                      | अर्थ                                                                    | जहाँ घोषणा गरिएको छ                                              |
| ----------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------------- |
| **क्याटलगमा समावेश**    | ड्यासबोर्ड क्याटलगमा देखिन्छ (नाम, विक्रेता, कागजात, कन्फिग प्रकार)     | `src/shared/constants/cliTools.ts` (`CLI_TOOLS`)                 |
| **पत्ता लगाउन मिल्ने**  | बाइनरी/कन्फिग पहिचान, स्वास्थ्य जाँच, कन्फिग पथहरू                      | `src/shared/services/cliRuntime.ts` (`CLI_TOOLS` रनटाइम क्याटलग) |
| **कन्फिगर गर्न मिल्ने** | `omniroute configure <cli>` द्वारा समर्थित (सेटअप विधि उपलब्ध छ)        | `bin/cli/cli-manifest.mjs` (`configure: true`)                   |
| **सुरु गर्न मिल्ने**    | `omniroute run <target>` द्वारा समर्थित (env/args इन्जेक्सन परिभाषित छ) | `bin/cli/cli-manifest.mjs` (`run: true`)                         |

`bin/cli/cli-manifest.mjs` CLI कमान्ड
सतहहरूका लागि आधिकारिक कार्यान्वयनयोग्य म्यानिफेस्ट हो: `run`, `configure` र शेल-कम्प्लिसन जेनेरेटरहरू सबैले आफ्ना
लक्ष्य सूचीहरू, उपनाम समाधान (उदाहरणका लागि `kilocode`/`kilo-code`/`kilo_cli` → `kilo`)
र `--model` फ्ल्यागको जडान यसैबाट प्राप्त गर्छन्। विचलन सुरक्षा
`tests/unit/cli/cli-manifest-drift.test.ts` ले म्यानिफेस्ट, रनटाइम
क्याटलग, UI क्याटलग र प्रत्येक उपभोक्ता सतह समक्रमित रहेको सुनिश्चित गर्छ — अन्य सतहहरूमा नथपी
एउटा सतहमा थपिएको लक्ष्यले मौन रूपमा विचलित हुनुको सट्टा परीक्षण सुइट असफल गराउँछ।

---

## 1. CLI Code को सूची (26 उपकरण)

`/dashboard/cli-code` मा देखिने सबै उपकरणहरू। `baseUrlSupport: none` भएका उपकरणहरू अनुकूलन base URL को सट्टा MITM वा म्यानुअल मार्गदर्शिकामार्फत जडान गरिएका छन्:

| id           | नाम                     | विक्रेता               | 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 (पूर्व-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 (पूर्व-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        |

`baseUrlSupport: "partial"` भएका उपकरणहरूले ड्यासबोर्ड कार्डमा "⚠ आंशिक Base URL" ब्याज देखाउँछन्।
---

## 2. CLI एजेन्टहरूको सूची (10 उपकरण)

`/dashboard/cli-agents` मा देखिने स्वायत्त एजेन्टहरू:

| id           | नाम              | विक्रेता                 | baseUrlSupport | acpSpawnable |
| ------------ | ---------------- | ------------------------ | -------------- | ------------ |
| hermes-agent | Hermes Agent     | Nous Research            | पूर्ण          | false        |
| openclaw     | OpenClaw         | OSS (P. Steinberger)     | पूर्ण          | true         |
| goose        | Goose            | Block / Linux Foundation | पूर्ण          | true         |
| interpreter  | Open Interpreter | OSS                      | पूर्ण          | true         |
| warp         | Warp AI          | Warp Inc.                | आंशिक          | true         |
| agent-deck   | Agent Deck       | asheshgoplani (OSS)      | पूर्ण          | false        |
| omp          | Oh My Pi         | OSS                      | पूर्ण          | true         |
| letta        | Letta CLI        | Letta                    | पूर्ण          | false        |
| prime-agent  | Prime Agent      | Prime Intellect (OSS)    | पूर्ण          | false        |
| 5dive        | 5dive            | OSS (5dive-ai)           | पूर्ण          | false        |

---

## 3. ACP एजेन्टहरू (/dashboard/acp-agents)

यो पृष्ठ (`/dashboard/agents` बाट पुनः नामकरण गरिएको) ले stdio/ACP प्रोटोकलमार्फत ब्याकएन्ड कार्यान्वयन इन्जिनका रूपमा OmniRoute ले **सुरु गर्न** सक्ने CLI हरू देखाउँछ। सूचीलाई `src/lib/acp/registry.ts` मा अलग्गै व्यवस्थापन गरिएको छ र यो `CLI_TOOLS` सँग **समान छैन**।

---

## 4. MITM बाँकी कार्यहरू (ड्यासबोर्डमा नदेखाइने)

निम्न CLI हरूले नेटिभ रूपमा आफूअनुकूल आधार URL समर्थन गर्दैनन् र CLI Code वा CLI Agents का पृष्ठहरूमा **सूचीबद्ध छैनन्**। तिनीहरू योजना 11 मा MITM इन्टरसेप्सनका उम्मेदवार हुन्:

| CLI                 | कारण                                                   |
| ------------------- | ------------------------------------------------------ |
| windsurf            | BYOK चयनित Claude मोडेलहरू + कर्पोरेट URL/टोकनमा सीमित |
| amp                 | बन्द इकोसिस्टम (Sourcegraph)                           |
| amazon-q / kiro-cli | AWS SSO प्रमाणीकरण, आफूअनुकूल URL छैन                  |
| cowork              | Anthropic Desktop, कन्फिगर गर्न मिल्ने एन्डपोइन्ट छैन  |

पूर्ण क्रस-रेफरेन्सका लागि `_tasks/features-v3.8.6/refactorpages/_orchestration/_plan11-mitm-backlog.md` हेर्नुहोस्।

---

## 5. ब्याच पहिचान API

सबै उपकरणको पहिचान एउटै एन्डपोइन्टमार्फत एकत्रित गरिन्छ:

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

- प्रमाणीकरण: `requireCliToolsAuth(request)` (अन्य `/api/cli-tools/` रुटहरूमा जस्तै)
- फिर्ता गर्छ: `Record<toolId, ToolBatchStatus>` (प्रकार: `src/shared/types/cliBatchStatus.ts`)
- रणनीति: सबै उपकरणहरूमा `Promise.all`, प्रत्येक उपकरणका लागि 5s टाइमआउट
- क्यास: कन्फिग फाइलको `mtime` द्वारा अनुक्रमित इन-मेमोरी LRU। mtime परिवर्तन हुँदा क्यास अमान्य हुन्छ। सर्भर पुनः सुरु हुँदा रिसेट हुन्छ।

प्रत्येक उपकरणको प्रतिक्रिया संरचना:

```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; // सफा गरिएको, स्ट्याक ट्रेसहरू छैनन्
}
```

---

## 6. नयाँ उपकरणहरूका लागि सेटिङ ह्यान्डलरहरू

`configType: "custom"` भएका नयाँ उपकरणहरूका लागि समर्पित सेटिङ API रुटहरू छन्:

| रुट                                         | उपकरण                                                             |
| ------------------------------------------- | ----------------------------------------------------------------- |
| `POST /api/cli-tools/forge-settings`        | ForgeCode (.forge.toml)                                           |
| `POST /api/cli-tools/jcode-settings`        | jcode (--base-url फ्ल्याग)                                        |
| `POST /api/cli-tools/deepseek-tui-settings` | DeepSeek TUI (OPENAI_BASE_URL, पुरानो)                            |
| `POST /api/cli-tools/codewhale-settings`    | CodeWhale (OPENAI_BASE_URL, प्राथमिक + पुरानो `~/.deepseek` सिंक) |
| `POST /api/cli-tools/smelt-settings`        | Smelt                                                             |
| `POST /api/cli-tools/pi-settings`           | 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` + समर्पित `.env` कुञ्जी)       |

सबै रुटहरूले त्रुटि प्रतिक्रियाहरूका लागि `sanitizeErrorMessage()` प्रयोग गर्छन् (कडा नियम #12)।

---

## 7. ड्यासबोर्ड पृष्ठहरूको आर्किटेक्चर

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

- `src/app/(dashboard)/dashboard/cli-code/page.tsx` — सर्भर कम्पोनेन्ट
- `src/app/(dashboard)/dashboard/cli-code/CliCodePageClient.tsx` — क्लाइन्ट ग्रिड
- `src/app/(dashboard)/dashboard/cli-code/[id]/page.tsx` — उपकरण विवरण पृष्ठ
- `src/app/(dashboard)/dashboard/cli-code/components/` — 12 विशेषीकृत उपकरण कार्डहरू + `ToolDetailClient.tsx`

### CLI एजेन्टहरू (`/dashboard/cli-agents`)

- `src/app/(dashboard)/dashboard/cli-agents/page.tsx` — सर्भर कम्पोनेन्ट
- `src/app/(dashboard)/dashboard/cli-agents/CliAgentsPageClient.tsx` — क्लाइन्ट ग्रिड
- `src/app/(dashboard)/dashboard/cli-agents/[id]/page.tsx` — `ToolDetailClient` पुनः प्रयोग गर्छ

### ACP एजेन्टहरू (`/dashboard/acp-agents`)

- `src/app/(dashboard)/dashboard/acp-agents/page.tsx` — सर्भर कम्पोनेन्ट (`agents/` बाट सारिएको)

### साझा UI कम्पोनेन्टहरू (`src/shared/components/cli/`)

| फाइल                    | उद्देश्य                                            |
| ----------------------- | --------------------------------------------------- |
| `CliToolCard.tsx`       | स्मार्ट स्थिति कार्ड (पहिचान + कन्फिग + एन्डपोइन्ट) |
| `CliConceptCard.tsx`    | प्रत्येक पृष्ठको अवधारणा व्याख्या कार्ड             |
| `CliComparisonCard.tsx` | CLI प्रकारहरूबीच तीन-स्तम्भीय तुलना                 |
| `BaseUrlSelect.tsx`     | एन्डपोइन्ट ड्रपडाउन (स्थानीय/क्लाउड/अनुकूलित)       |
| `ApiKeySelect.tsx`      | API कुञ्जी चयनकर्ता                                 |
| `ManualConfigModal.tsx` | प्रतिलिपि गर्न मिल्ने कन्फिग स्निपेट मोडल           |

### साझा हुक (`src/shared/hooks/cli/`)

| फाइल                      | उद्देश्य                                                                         |
| ------------------------- | -------------------------------------------------------------------------------- |
| `useToolBatchStatuses.ts` | `/api/cli-tools/all-statuses` प्राप्त गर्छ, लोडिङ/रिफ्रेस स्थिति व्यवस्थापन गर्छ |

---

## 8. i18n

योजना 14 F9 मा थपिएका नयाँ नेमस्पेसहरू:

| नेमस्पेस    | उद्देश्य                                                                     |
| ----------- | ---------------------------------------------------------------------------- |
| `cliCommon` | साझा स्ट्रिङहरू (कार्ड लेबलहरू, अवधारणा/तुलना पाठहरू, विवरण पृष्ठका लेबलहरू) |
| `cliCode`   | CLI Code पृष्ठका स्ट्रिङहरू                                                  |
| `cliAgents` | CLI Agents पृष्ठका स्ट्रिङहरू                                                |
| `acpAgents` | ACP Agents पृष्ठका स्ट्रिङहरू                                                |

पूर्ण PT-BR र EN अनुवादहरू उपलब्ध गराइएका छन्। अन्य 39 लोकेलहरू `src/i18n/request.ts` मा नेमस्पेस-स्तरीय मर्जमार्फत स्वतः EN मा फर्कन्छन्।

---

## 9. द्रुत सुरुवात

### चरण 1 — OmniRoute API कुञ्जी प्राप्त गर्नुहोस्

1. `/dashboard/api-manager` खोल्नुहोस् → **API कुञ्जी सिर्जना गर्नुहोस्**
2. यसलाई एउटा नाम दिनुहोस् (जस्तै `cli-tools`) र सबै अनुमतिहरू चयन गर्नुहोस्
3. कुञ्जी प्रतिलिपि गर्नुहोस् — तलका प्रत्येक CLI का लागि तपाईंलाई यसको आवश्यकता पर्नेछ

> तपाईंको कुञ्जी यस्तो देखिन्छ: `sk-xxxxxxxxxxxxxxxx-xxxxxxxxx`

---

### चरण 2 — CLI उपकरणहरू स्थापना गर्नुहोस्

सबै npm-आधारित उपकरणहरूलाई Node.js 22.22.2+ वा 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 (`omniroute run gemini` मार्फत सुरु गर्न मिल्ने → /v1beta सतह)
npm install -g @google/gemini-cli

# Aider
pip install aider-chat

# Smelt
cargo install smelt  # Rust-आधारित

# Pi coding agent
# स्थापनाका लागि https://github.com/zechnerj/pi-coding-agent हेर्नुहोस्

# jcode
# स्थापनाका लागि https://github.com/1jehuang/jcode हेर्नुहोस्
```

---

### चरण 3 — ड्यासबोर्डमार्फत कन्फिगर गर्नुहोस्

1. `http://localhost:20128/dashboard/cli-code` मा जानुहोस्
2. ग्रिडमा आफ्नो उपकरण फेला पार्नुहोस्
3. उपकरणको विवरण पृष्ठ खोल्न कार्डमा क्लिक गर्नुहोस्
4. आफ्नो API कुञ्जी र आधार URL चयन गर्नुहोस्
5. **कन्फिग लागू गर्नुहोस्** मा क्लिक गर्नुहोस् वा म्यानुअल कन्फिग स्निपेट प्रतिलिपि गर्नुहोस्

---

### चरण 4 — ग्लोबल वातावरण चरहरू सेट गर्नुहोस्

```bash
# 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 ले मूलमा GOOGLE_GEMINI_BASE_URL पढ्छ (यसको SDK ले आफैँ /v1beta/... थप्छ)
export GOOGLE_GEMINI_BASE_URL="http://localhost:20128"
export GEMINI_API_KEY="sk-your-omniroute-key"
```

> **रिमोट सर्भर** का लागि `localhost:20128` लाई सर्भर IP वा डोमेनले प्रतिस्थापन गर्नुहोस्,
> जस्तै `http://<your-server-ip>:20128`।

---

### चरण 4 — प्रत्येक उपकरण कन्फिगर गर्नुहोस्

#### Claude Code

```bash
# ~/.claude/settings.json सिर्जना गर्नुहोस्:
mkdir -p ~/.claude && cat > ~/.claude/settings.json << EOF
{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:20128",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-omniroute-key"
  }
}
EOF
```

Claude Code का लागि एकीकृत Anthropic गेटवे रुट प्रयोग गर्नुहोस्। यहाँ `/v1` नथप्नुहोस्।

**परीक्षण:** `claude "say hello"`

---

#### OpenAI Codex

आधुनिक Codex (v0.137+) ले `~/.codex/config.toml` मात्र पढ्छ — पुरानो
`config.yaml` लिगेसी npm CLI सँग सम्बन्धित छ र कुनै सूचना नदिई बेवास्ता गरिन्छ। API
कुञ्जी सधैँ `OMNIROUTE_API_KEY` वातावरण चर (`env_key`) मा रहन्छ, फाइलभित्र
कहिल्यै रहँदैन:

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

पूर्ण सन्दर्भ (प्रोफाइलहरू, `wire_api`, कन्टेक्स्ट विन्डोहरू): [CODEX-CLI-CONFIGURATION.md](../guides/CODEX-CLI-CONFIGURATION.md)।

**परीक्षण:** `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
```

**परीक्षण:** `opencode`

> थिङ्किङ भेरियन्टहरू पठाउन
> `opencode run "your prompt" --model omniroute/claude-sonnet-4-5-thinking --variant high` प्रयोग गर्नुहोस्।

---

#### Cline (CLI वा VS Code)

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

**VS Code मोड:**
Cline एक्सटेन्सन सेटिङहरू → API प्रदायक: `OpenAI Compatible` → आधार URL: `http://localhost:20128/v1`

वा OmniRoute ड्यासबोर्ड → **CLI उपकरणहरू → Cline → कन्फिग लागू गर्नुहोस्** प्रयोग गर्नुहोस्।

---

#### KiloCode (CLI वा VS Code)

**CLI मोड:**

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

**VS Code सेटिङहरू:**

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

वा OmniRoute ड्यासबोर्ड → **CLI उपकरणहरू → KiloCode → कन्फिग लागू गर्नुहोस्** प्रयोग गर्नुहोस्।

---

#### Continue (VS Code एक्सटेन्सन)

`~/.continue/config.yaml` सम्पादन गर्नुहोस्:

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

सम्पादन गरेपछि VS Code पुनः सुरु गर्नुहोस्।

---

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

VS Code Insiders लाई कस्टम एन्डपोइन्ट मोडेलहरूका लागि कन्फिगर गरिएको छ र तपाईं OmniRoute लाई कस्टम हेडर फिल्डबिना चलाउन चाहनुहुन्छ भने यो प्रयोग गर्नुहोस्।

**सिफारिस गरिएको स्थान:**

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

**टोकनयुक्त OmniRoute उपनाम प्रयोग गर्ने उदाहरण:**

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

**टिप्पणीहरू:**

- `sk-your-omniroute-key` लाई OmniRoute मा सिर्जना गरिएको API कुञ्जीले प्रतिस्थापन गर्नुहोस्।
- `url` फिल्डले `/api/v1/vscode/{token}/chat/completions` लाई सङ्केत गर्नुपर्छ।
- `modelsUrl` फिल्डले `/api/v1/vscode/{token}/models` लाई सङ्केत गर्नुपर्छ।
- क्लाइन्टले अनुकूलन हेडरहरू समर्थन गर्दा सामान्य `/v1` + Bearer हेडर प्रवाहलाई प्राथमिकता दिनुहोस्।
- URL मा समावेश गरिएका टोकनहरू अनुकूलताको वैकल्पिक उपाय हुन् र ती सम्पादक लगहरू वा प्रोक्सी इतिहासमा देखिन सक्छन्।

---

#### Kiro CLI (Amazon)

```bash
# आफ्नो AWS/Kiro खातामा लगइन गर्नुहोस्:
kiro-cli login

# CLI ले आफ्नै प्रमाणीकरण प्रयोग गर्छ — Kiro CLI कै ब्याकइन्डका रूपमा OmniRoute आवश्यक पर्दैन।
# अन्य उपकरणहरूका लागि OmniRoute सँगसँगै kiro-cli प्रयोग गर्नुहोस्।
kiro-cli status
```

**Kiro IDE** डेस्कटप एपका लागि, OmniRoute द्वारा उपलब्ध गराइएको MITM अन्तबिन्दु
`/dashboard/cli-tools → Kiro` अन्तर्गत प्रयोग गर्नुहोस्।

---

## 10. आन्तरिक OmniRoute CLI

`omniroute` बाइनरीले सर्भर जीवनचक्र, सेटअप, निदान, र प्रदायक व्यवस्थापनका लागि आदेशहरू उपलब्ध गराउँछ। प्रवेश बिन्दु: `bin/omniroute.mjs`।

```bash
omniroute                              # सर्भर सुरु गर्नुहोस् (पूर्वनिर्धारित पोर्ट 20128)
omniroute setup                        # अन्तरक्रियात्मक सेटअप विजार्ड
omniroute doctor                       # कन्फिग, DB, पोर्टहरू र रनटाइम जाँच गर्नुहोस्
omniroute providers list               # कन्फिगर गरिएका प्रदायक जडानहरू
omniroute providers test-all           # प्रत्येक सक्रिय जडान परीक्षण गर्नुहोस्
omniroute reset-password               # प्रशासकको पासवर्ड रिसेट गर्नुहोस्
omniroute logs                         # अनुरोध लगहरू स्ट्रिम गर्नुहोस्
omniroute health                       # विस्तृत स्वास्थ्य स्थिति (ब्रेकरहरू, क्यास, मेमोरी)
omniroute --version                    # संस्करण देखाउनुहोस्
omniroute --help                       # सबै आदेशहरू देखाउनुहोस्
```

### सेटअप र प्रारम्भीकरण

```bash
omniroute setup                        # अन्तरक्रियात्मक सेटअप विजार्ड
omniroute setup --non-interactive      # CI/स्वचालन मोड (env vars + flags पढ्छ)
omniroute setup --password '<value>'   # प्रशासकको पासवर्ड सिधै सेट गर्नुहोस्
omniroute setup --add-provider \
  --provider openai \
  --api-key '<value>' \
  --test-provider                      # एकै पटक प्रदायक थप्नुहोस् र परीक्षण गर्नुहोस्
```

गैर-अन्तरक्रियात्मक सेटअपका लागि पहिचान गरिने वातावरण चरहरू:

| चर                  | उद्देश्य                                                                |
| ------------------- | ----------------------------------------------------------------------- |
| `OMNIROUTE_API_KEY` | प्रदायक API कुञ्जी (Commander `.env()` मार्फत `--api-key` सँग बाँधिएको) |
| `DATA_DIR`          | OmniRoute डेटा डाइरेक्टरीलाई अधिलेखन गर्नुहोस्                          |

अन्य सबै गैर-अन्तरक्रियात्मक इनपुटहरू वातावरण चरका रूपमा नभई फ्ल्यागका रूपमा पास गरिन्छन्:
`--password`, `--provider`, `--provider-name`, `--provider-base-url`, `--default-model`
(माथिका `omniroute setup` विकल्पहरू हेर्नुहोस्)।

### निदान

```bash
omniroute doctor                       # कन्फिग, DB, पोर्टहरू, रनटाइम, मेमोरी र सक्रियता जाँच गर्नुहोस्
omniroute doctor --json                # मेसिनले पढ्न मिल्ने JSON
omniroute doctor --no-liveness         # HTTP स्वास्थ्य परीक्षण छाड्नुहोस्
omniroute doctor --host 0.0.0.0        # सक्रियता होस्ट अधिलेखन गर्नुहोस्
omniroute doctor --liveness-url <url>  # पूर्ण स्वास्थ्य अन्त्यबिन्दु URL अधिलेखन गर्नुहोस्
```

doctor ले यी जाँचहरू चलाउँछ: `Config`, `Database`, `Storage/encryption`,
`Port availability`, `Node runtime`, `Native binary` (better-sqlite3),
`Memory`, र `Server liveness`। कुनै पनि जाँच `fail` भएमा यो गैर-शून्य निकास कोडसहित बन्द हुन्छ।

### प्रदायक व्यवस्थापन

```bash
omniroute providers available                       # OmniRoute प्रदायक सूची
omniroute providers available --search openai       # id/name/alias/category अनुसार सूची फिल्टर गर्नुहोस्
omniroute providers available --category api-key    # श्रेणीअनुसार फिल्टर गर्नुहोस् (api-key, oauth, free, ...)
omniroute providers available --json                # मेसिनले पढ्न मिल्ने JSON

omniroute providers list                            # कन्फिगर गरिएका प्रदायक जडानहरू
omniroute providers list --json

omniroute providers test <id|name>                  # एउटा कन्फिगर गरिएको जडान परीक्षण गर्नुहोस्
omniroute providers test-all                        # प्रत्येक सक्रिय जडान परीक्षण गर्नुहोस्
omniroute providers validate                        # स्थानीय-मात्र संरचनात्मक प्रमाणीकरण
omniroute providers add <provider> --credential-env PROVIDER_KEY
omniroute providers import ./providers.json --dry-run --json
omniroute providers auth <provider>                 # विद्यमान OAuth प्रवाह
omniroute providers edit <id|name> --default-model <model>
omniroute providers remove <id|name> --yes
```

`providers add/import/auth/edit/remove` API-प्रथम हुन् र त्यसैले सक्रिय स्थानीय वा दूरस्थ सन्दर्भमा
काम गर्छन्। प्रमाणपत्र इनपुटका लागि `--credential-stdin` वा `--credential-env` प्रयोग गर्नुपर्छ;
`--dry-run --json` ले संशोधित उपस्थिति/आकार मात्र रिपोर्ट गर्छ। `providers available` ले OmniRoute
सूची पढ्छ; `providers list/test/test-all/validate` ले तिनको स्थानीय SQLite व्यवहार कायम राख्छन् र
सर्भर चलिरहेको हुनु आवश्यक पर्दैन।

### पुनःप्राप्ति र रिसेट

```bash
omniroute reset-password                # प्रशासकको पासवर्ड रिसेट गर्नुहोस् (यो पनि: omniroute-reset-password)
omniroute reset-encrypted-columns       # इन्क्रिप्ट गरिएका प्रमाणपत्र रिसेटका लागि चेतावनी + dry-run देखाउनुहोस्
omniroute reset-encrypted-columns --force  # SQLite मा इन्क्रिप्ट गरिएका प्रमाणपत्रहरू वास्तवमै null बनाउनुहोस्
```

### प्रमाणपत्र निर्यात (⚠ सावधानीपूर्वक सम्हाल्नुहोस्)

```bash
omniroute auth export                                 # चेतावनी + पुष्टि द्वार देखाउनुहोस् — DB पहुँच हुँदैन
omniroute auth export --force                          # सबै जडानका डिक्रिप्ट गरिएका प्रमाणपत्रहरू JSON का रूपमा stdout मा निर्यात गर्नुहोस्
omniroute auth export --force --id <id>                 # मेल खाने जडान मात्र निर्यात गर्नुहोस्
omniroute auth export --force --format env               # OMNIROUTE_<PROVIDER>_<FIELD>=<value> लाइनहरू उत्सर्जन गर्नुहोस्
omniroute auth export --force --out creds.json           # फाइलमा लेख्नुहोस् (0600 अनुमतिसहित सिर्जना गरिन्छ)
```

`auth export` **स्थानीय-मात्र** हो (प्रत्यक्ष SQLite पढाइ, HTTP रुट छैन) र यसले जानाजानी
**सादा पाठ** `apiKey`/`accessToken`/`refreshToken`/`idToken` मानहरू देखाउँछ/लेख्छ — यो त्रुटि होइन,
यसकै विशेषता हो। `--force` बिना डेटाबेसबाट केही पनि पढिँदैन र केही पनि डिक्रिप्ट गरिँदैन। कुनै
सादा पाठ उत्सर्जन हुनुअघि stderr मा सधैँ चेतावनी ब्यानर देखाइन्छ। `STORAGE_ENCRYPTION_KEY` सेट
गरिएको हुनुपर्छ। डिक्रिप्ट गर्न असफल भएको फिल्ड (पुरानो कुञ्जी, बिग्रिएको ciphertext) का लागि सम्पूर्ण
निर्यात रद्द गर्नु वा अन्तर्निहित त्रुटि चुहाउनुको सट्टा `<field>DecryptFailed: true` रिपोर्ट गरिन्छ।

### अन्य उपआदेशहरू

अन्यथा उल्लेख नगरिएसम्म, यिनले चलिरहेको OmniRoute सर्भर भएको मान्छन्:

```bash
omniroute status                       # विस्तृत रनटाइम स्थिति
omniroute logs                         # अनुरोध लगहरू स्ट्रिम गर्नुहोस् (--json, --search, --follow)
omniroute config list                  # कन्फिगर गरिएका CLI उपकरणहरू देखाउनुहोस्

omniroute provider list                # उपलब्ध प्रदायकहरू सूचीबद्ध गर्नुहोस् (providers list को उपनाम)
omniroute provider add                 # कुनै उपकरणमा OmniRoute लाई प्रदायकका रूपमा दर्ता गर्नुहोस्
omniroute keys add | list | remove     # API कुञ्जीहरू व्यवस्थापन गर्नुहोस्
omniroute models [provider]            # मोडेलहरू सूचीबद्ध गर्नुहोस् (--json, --search)
omniroute combo list | switch | create | delete

omniroute backup                       # कन्फिगरेसन + DB को स्न्यापसट लिनुहोस्
omniroute restore                      # अघिल्लो स्न्यापसटबाट पुनर्स्थापना गर्नुहोस्

omniroute health                       # विस्तृत स्वास्थ्य स्थिति (ब्रेकरहरू, क्यास, मेमोरी)
omniroute quota                        # प्रदायक कोटा उपयोग
omniroute cache                        # क्यास स्थिति
omniroute cache clear                  # सिमान्टिक + सिग्नेचर क्यासहरू खाली गर्नुहोस्

omniroute mcp status | restart         # MCP सर्भरको स्थिति / पुनः सुरु
omniroute a2a status | card            # A2A सर्भरको स्थिति / एजेन्ट कार्ड

omniroute tunnel list | create | stop  # टनेलहरू व्यवस्थापन गर्नुहोस् (cloudflare/tailscale/ngrok)
omniroute env show | get <k> | set <k> <v>  # वातावरणीय चरहरू निरीक्षण / सेट गर्नुहोस् (अस्थायी)

omniroute test                         # प्रदायक कनेक्टिभिटीको आधारभूत परीक्षण
omniroute update                       # अद्यावधिकहरू जाँच गर्नुहोस्
omniroute completion                   # शेल कम्प्लिसन उत्पन्न गर्नुहोस्
```

### सामान्य फ्ल्यागहरू

| फ्ल्याग             | विवरण                                                      |
| ------------------- | ---------------------------------------------------------- |
| `--no-open`         | सुरु हुँदा ब्राउजर स्वतः नखोल्नुहोस्                       |
| `--port <n>`        | API पोर्ट अधिलेखन गर्नुहोस् (पूर्वनिर्धारित 20128)         |
| `--mcp`             | stdio मार्फत MCP सर्भरका रूपमा चलाउनुहोस् (IDE हरूका लागि) |
| `--non-interactive` | CI मोड (कुनै प्रम्प्ट छैन; env/फ्ल्यागहरूबाट पढ्छ)         |
| `--json`            | मेसिनले पढ्न मिल्ने JSON आउटपुट (doctor, providers, आदि)   |
| `--help`, `-h`      | कमान्ड-विशिष्ट मद्दत देखाउनुहोस्                           |
| `--version`, `-v`   | इन्स्टल गरिएको संस्करण प्रिन्ट गर्नुहोस्                   |

---

## उपलब्ध API Endpoints

| Endpoint                   | विवरण                        | प्रयोगको उद्देश्य                      |
| -------------------------- | ---------------------------- | -------------------------------------- |
| `/v1/chat/completions`     | मानक च्याट (सबै प्रदायकहरू)  | सबै आधुनिक उपकरणहरू                    |
| `/v1/responses`            | Responses API (OpenAI ढाँचा) | Codex, एजेन्टिक कार्यप्रवाहहरू         |
| `/v1/completions`          | लिगेसी पाठ पूर्णताहरू        | `prompt:` प्रयोग गर्ने पुराना उपकरणहरू |
| `/v1/embeddings`           | पाठ एम्बेडिङहरू              | RAG, खोज                               |
| `/v1/images/generations`   | छवि निर्माण                  | GPT-Image, Flux, आदि                   |
| `/v1/audio/speech`         | पाठबाट वाणी                  | ElevenLabs, OpenAI TTS                 |
| `/v1/audio/transcriptions` | वाणीबाट पाठ                  | Deepgram, AssemblyAI                   |

टोकनयुक्त OmniRoute URL सहित सीधै पेस्ट गर्न मिल्ने उदाहरणहरू:

```txt
टोकन उदाहरण: sk-a3ab3c080beaee3a-69f4a4-070d71af

मानक OpenAI आधार: http://localhost:20128/v1
VS Code मोडेलहरू: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/models
VS Code च्याट: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/chat/completions
VS Code प्रतिक्रियाहरू: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/responses
Ollama ट्यागहरू: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/api/tags
Ollama च्याट: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/api/chat
```

---

## समस्या समाधान

| त्रुटि                                             | कारण                         | समाधान                                                  |
| -------------------------------------------------- | ---------------------------- | ------------------------------------------------------- |
| `Connection refused`                               | OmniRoute चलिरहेको छैन       | `omniroute serve`                                       |
| `401 Unauthorized`                                 | गलत API key                  | `/dashboard/api-manager` मा जाँच गर्नुहोस्              |
| `No combo configured`                              | कुनै सक्रिय राउटिङ combo छैन | `/dashboard/combos` मा सेटअप गर्नुहोस्                  |
| CLI ले "not installed" देखाउँछ                     | बाइनरी PATH मा छैन           | `which <command>` जाँच गर्नुहोस्                        |
| स्थापना गरेपछि ड्यासबोर्डले "not detected" देखाउँछ | क्यास पुरानो छ               | ड्यासबोर्डमा "⟳ Refresh detection" क्लिक गर्नुहोस्      |
| पुरानो लिङ्क `/dashboard/cli-tools`                | v3.8.6-अघिको बुकमार्क        | `/dashboard/cli-code` मा स्वतः रिडाइरेक्ट हुन्छ (308)   |
| पुरानो लिङ्क `/dashboard/agents`                   | v3.8.6-अघिको बुकमार्क        | `/dashboard/acp-agents` मा स्वतः रिडाइरेक्ट हुन्छ (308) |