mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-09-20 05:42:19 +03:00

Files

Diego Rodrigues de Sa e Souza b637350680 fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

1,104 mirrors rewritten over five passes of run-translation on the 22-source core set: the 14 sources edited since their translation, the 322 mirrors that were still English copies, and the frontmatter the old extractor leaked into the newer locales' bodies. The pipeline now caches per-`## `-section hashes and retranslates only changed sections, never reuses a section that is still English, rebuilds English-copy / leaked mirrors even when the source is unchanged, merges the state on save (parallel runs), and the drift gate (scoped to the core set) is blocking. Final audit: 0 stale, 0 English copies, 0 leaked frontmatter across 1,430 core mirrors.

⚠️ base-red inherited: #12732

2026-09-17 02:55:31 -03:00

63 KiB

Raw Blame History

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

🌐 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 · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

अन्तिम अद्यावधिक: 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 (स्थानीय वा रिमोट) बाट लाइभ मोडेल क्याटलग पढ्छ र तपाईंको मेसिनमा उक्त उपकरणको आफ्नै कन्फिग लेख्छ:

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 अन्तर्गत लेख्दैन: यसले फ्लीट होस्टमा root-स्वामित्वको प्रमाणीकरण प्रोफाइल लेखेर 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 एकीकरणहरू।

यी कमाण्डहरू कन्टेनरभित्र चलाउँदा

OmniRoute कन्टेनरभित्र कार्यान्वयन गरिएको setup-* कमाण्डले कन्टेनरको आफ्नै home मा लेख्छ, जसलाई कुनै पनि होस्ट CLI ले पढ्दैन र जुन कन्टेनरसँगै हराउँछ। OmniRoute ले यो अवस्था पत्ता लगाउँछ र लेख्नुको सट्टा निर्देशनसहित 2 मा बाहिरिन्छ। अगाडि बढ्ने दुई समर्थित तरिकाहरू छन् — होस्टमा CLI स्थापना गरेर कन्टेनरसँग omniroute connect गर्नुहोस्, वा कन्फिग डाइरेक्टरीहरू bind-mount गरेर CLI_CONFIG_HOME (compose host प्रोफाइल) सेट गर्नुहोस्। प्रत्येक setup-* कमाण्डका साथै omniroute configure र omniroute config set ले कन्टेनरकै आफ्ना CLI हरू कन्फिगर गर्नु तपाईंको वास्तविक उद्देश्य हुँदा --allow-container-write स्वीकार गर्छन्; सर्भरका लागि OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE=true ले पनि यही काम गर्छ। हेर्नुहोस्: Docker गाइड → होस्ट CLI उपकरणहरू कन्फिगर गर्ने।

ड्यासबोर्डको लागू गर्ने एन्डपोइन्ट (POST /api/cli-tools/apply) ले पनि उही सुरक्षा लागू गर्छ: कन्टेनरमा, होस्टबाट bind-mount नगरिएको टार्गेटमा लेख्ने प्रयासले 422 सहित containerEphemeralTarget: true, सुरक्षित त्रुटि पाठ र — होस्ट रेसिपी भएका उपकरणहरूका लागि (claude, codex, opencode, cline, kilo, continue) — त्यसको सट्टा होस्टमा चलाउनुपर्ने hostSetupCommand (जस्तै omniroute setup-opencode) फर्काउँछ; केही पनि लेखिँदैन। dryRun: true ले कन्टेनर मोडमा काम गरिरहन्छ र डिस्क नछोई उत्पन्न गरिएको सामग्री + टार्गेट पाथ फर्काउँछ, जसले गर्दा तपाईं ड्यासबोर्डबाट पूर्वावलोकन गरेर होस्टमा लागू गर्न सक्नुहुन्छ। यो व्यवहार जानाजानी राखिएको हो र 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 परिवर्तन हुँदा क्यास अमान्य हुन्छ। सर्भर पुनः सुरु हुँदा रिसेट हुन्छ।

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

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 कुञ्जी प्राप्त गर्नुहोस्

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

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

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

सबै npm-आधारित उपकरणहरूलाई Node.js 22.22.2+ वा 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 (`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 — ड्यासबोर्डमार्फत कन्फिगर गर्नुहोस्

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

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

# 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

# ~/.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) मा रहन्छ, फाइलभित्र कहिल्यै रहँदैन:

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।

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

परीक्षण: opencode

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

Cline (CLI वा VS Code)

CLI मोड:

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 मोड:

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

VS Code सेटिङहरू:

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

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

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

~/.continue/config.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 उपनाम प्रयोग गर्ने उदाहरण:

[
  {
    "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)

# आफ्नो 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।

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                       # सबै आदेशहरू देखाउनुहोस्

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

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 विकल्पहरू हेर्नुहोस्)।

निदान

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 भएमा यो शून्यबाहेकको निकास कोडसहित बन्द हुन्छ।

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

omniroute providers available                       # OmniRoute प्रदायक क्याटलग
omniroute providers available --search openai       # id/name/alias/category अनुसार क्याटलग फिल्टर गर्नुहोस्
omniroute providers available --category api-key    # category अनुसार फिल्टर गर्नुहोस् (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 व्यवहार कायम राख्छन् र सर्भर चलिरहेको हुनु आवश्यक पर्दैन।

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

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

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

omniroute auth export                                 # चेतावनी + पुष्टिकरण गेट देखाउनुहोस् — DB पहुँच हुँदैन
omniroute auth export --force                          # सबै जडानका डिक्रिप्ट गरिएका प्रमाणपत्रहरू stdout मा JSON का रूपमा निर्यात गर्नुहोस्
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 सेट गरिएको हुनुपर्छ। डिक्रिप्ट गर्न असफल हुने फिल्ड (पुरानो कुञ्जी, बिग्रिएको साइफरटेक्स्ट) लाई सम्पूर्ण निर्यात रद्द गर्नु वा अन्तर्निहित त्रुटि चुहाउनुको सट्टा <field>DecryptFailed: true का रूपमा रिपोर्ट गरिन्छ।

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

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

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

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 सहित सीधै पेस्ट गर्न मिल्ने उदाहरणहरू:

टोकन उदाहरण: 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)

63 KiB Raw Blame History Unescape Escape