pjandro/OmniRoute
1
0
Fork 0
mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-09-19 05:12:16 +03:00
Code Issues Packages Projects Releases Wiki Activity
Files
fde6241d41afbb5ca0cd2d91b002c016d7df2b32
OmniRoute/docs/i18n/pa/docs/reference/CLI-TOOLS.md
Diego Rodrigues de Sa e Souza 58f88a83e4 feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727) 
Batch 3 (last) of the locale-expansion plan: ha, yo, ig, am, uz, ka, hy on every surface — dashboard catalog, docs mirror (22-file core + llm.txt + CHANGELOG), CLI catalog, README flag block, locale tables and 🌐 language bars. Also closes the key gap the batch-1 (43 keys) and batch-2 (10 keys) catalogs carried since their base merges, fixes the Igbo "Model" copy and allowlists the Uzbek cognate. Translation-ratio baseline covers 65 locales.

⚠️ base-red inherited: #12732
2026-09-15 09:50:01 -03:00

60 KiB
Raw Blame History

CLI-TOOLS (ਪੰਜਾਬੀ)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇵🇭 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

title: "CLI ਟੂਲ — OmniRoute" version: 3.8.50 lastUpdated: 2026-08-23

CLI ਟੂਲ — OmniRoute

ਆਖਰੀ ਅੱਪਡੇਟ: 2026-08-23

OmniRoute ਤਿੰਨ ਸਮਰਪਿਤ ਡੈਸ਼ਬੋਰਡ ਪੰਨਿਆਂ ਵਿੱਚ ਵੰਡੀਆਂ CLI ਟੂਲਾਂ ਦੀਆਂ ਤਿੰਨ ਸ਼੍ਰੇਣੀਆਂ ਨਾਲ ਏਕੀਕ੍ਰਿਤ ਹੁੰਦਾ ਹੈ:

ਪੰਨਾ ਰੂਟ ਧਾਰਨਾ ਗਿਣਤੀ
CLI ਕੋਡ /dashboard/cli-code ਕੋਡਿੰਗ ਟੂਲ ਜਿਨ੍ਹਾਂ ਨੂੰ ਤੁਸੀਂ OmniRoute ਵੱਲ ਭੇਜਦੇ ਹੋ (ਕਲਾਇੰਟ → CLI → OmniRoute → ਪ੍ਰਦਾਤਾ) 26
CLI ਏਜੰਟ /dashboard/cli-agents ਖੁਦਮੁਖਤਿਆਰ ਏਜੰਟ ਜਿਨ੍ਹਾਂ ਨੂੰ ਤੁਸੀਂ OmniRoute ਵੱਲ ਭੇਜਦੇ ਹੋ (ਉਹੀ ਪ੍ਰਵਾਹ, ਵਿਆਪਕ ਦਾਇਰਾ) 10
ACP ਏਜੰਟ /dashboard/acp-agents ਉਹ CLIs ਜਿਨ੍ਹਾਂ ਨੂੰ OmniRoute stdio/ACP ਰਾਹੀਂ ਬੈਕਐਂਡ ਵਜੋਂ ਸ਼ੁਰੂ ਕਰਦਾ ਹੈ (ਉਲਟਾ ਪ੍ਰਵਾਹ) ਰਜਿਸਟਰੀ ਵੇਖੋ

ਪੁਰਾਣੇ ਰੂਟ 308 ਰਾਹੀਂ ਰੀਡਾਇਰੈਕਟ ਹੁੰਦੇ ਹਨ: /dashboard/cli-tools → /dashboard/cli-code, /dashboard/agents → /dashboard/acp-agents।

ਇਹ ਕਿਵੇਂ ਕੰਮ ਕਰਦਾ ਹੈ

CLI ਕੋਡ / CLI ਏਜੰਟ (ਖਪਤ ਪ੍ਰਵਾਹ):
Claude / Codex / OpenCode / Cline / KiloCode / Continue / Hermes Agent / Goose / ...
           │
           ▼  (ਸਾਰੇ OmniRoute ਵੱਲ ਇਸ਼ਾਰਾ ਕਰਦੇ ਹਨ)
    http://YOUR_SERVER:20128/v1
           │
           ▼  (OmniRoute ਬੇਨਤੀ ਨੂੰ ਸਹੀ ਪ੍ਰਦਾਤਾ ਵੱਲ ਭੇਜਦਾ ਹੈ)
    Anthropic / OpenAI / Gemini / DeepSeek / Groq / Mistral / ...

ACP ਏਜੰਟ (ਉਲਟਾ ਸ਼ੁਰੂਆਤੀ ਪ੍ਰਵਾਹ):
    ਕਲਾਇੰਟ ਬੇਨਤੀ → OmniRoute → stdio/ACP ਰਾਹੀਂ CLI ਸ਼ੁਰੂ ਕਰਦਾ ਹੈ → ਜਵਾਬ

ਲਾਭ:

  • ਸਾਰੇ ਟੂਲਾਂ ਦਾ ਪ੍ਰਬੰਧਨ ਕਰਨ ਲਈ ਇੱਕ API ਕੁੰਜੀ
  • ਡੈਸ਼ਬੋਰਡ ਵਿੱਚ ਸਾਰੇ CLIs ਲਈ ਲਾਗਤ ਦੀ ਟ੍ਰੈਕਿੰਗ
  • ਹਰੇਕ ਟੂਲ ਨੂੰ ਮੁੜ ਸੰਰਚਿਤ ਕੀਤੇ ਬਿਨਾਂ ਮਾਡਲ ਬਦਲਣਾ
  • ਸਥਾਨਕ ਤੌਰ 'ਤੇ ਅਤੇ ਰਿਮੋਟ ਸਰਵਰਾਂ ਉੱਤੇ ਕੰਮ ਕਰਦਾ ਹੈ (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 ਦੀ ਮਲਕੀਅਤ ਵਾਲਾ auth ਪ੍ਰੋਫ਼ਾਈਲ ਲਿਖ ਕੇ 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-* ਕਮਾਂਡ ਕੰਟੇਨਰ ਦੀ ਆਪਣੀ ਹੋਮ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਲਿਖਦੀ ਹੈ, ਜਿਸਨੂੰ ਕੋਈ ਹੋਸਟ CLI ਨਹੀਂ ਪੜ੍ਹਦਾ ਅਤੇ ਜੋ ਕੰਟੇਨਰ ਨਾਲ ਹੀ ਗਾਇਬ ਹੋ ਜਾਂਦੀ ਹੈ। OmniRoute ਇਸਦਾ ਪਤਾ ਲਗਾਉਂਦਾ ਹੈ ਅਤੇ ਲਿਖਣ ਦੀ ਬਜਾਏ ਹਦਾਇਤਾਂ ਦੇ ਨਾਲ 2 ਕੋਡ ਉੱਤੇ ਬੰਦ ਹੋ ਜਾਂਦਾ ਹੈ। ਅੱਗੇ ਵਧਣ ਦੇ ਦੋ ਸਮਰਥਿਤ ਤਰੀਕੇ ਹਨ — ਹੋਸਟ ਉੱਤੇ CLI ਇੰਸਟਾਲ ਕਰੋ ਅਤੇ ਕੰਟੇਨਰ ਨਾਲ omniroute connect ਕਰੋ, ਜਾਂ ਸੰਰਚਨਾ ਡਾਇਰੈਕਟਰੀਆਂ ਨੂੰ bind-mount ਕਰੋ ਅਤੇ CLI_CONFIG_HOME ਸੈੱਟ ਕਰੋ (compose host ਪ੍ਰੋਫ਼ਾਈਲ)। ਹਰੇਕ setup-* ਕਮਾਂਡ, ਅਤੇ ਨਾਲ ਹੀ omniroute configure ਅਤੇ omniroute config set, --allow-container-write ਸਵੀਕਾਰ ਕਰਦੀਆਂ ਹਨ ਜਦੋਂ ਤੁਸੀਂ ਅਸਲ ਵਿੱਚ ਕੰਟੇਨਰ ਦੇ ਆਪਣੇ CLIs ਨੂੰ ਹੀ ਸੰਰਚਿਤ ਕਰਨਾ ਚਾਹੁੰਦੇ ਹੋ; ਸਰਵਰ ਲਈ OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE=true ਵੀ ਇਹੀ ਕੰਮ ਕਰਦਾ ਹੈ। ਵੇਖੋ Docker ਗਾਈਡ → ਹੋਸਟ CLI ਟੂਲਾਂ ਦੀ ਸੰਰਚਨਾ।

ਡੈਸ਼ਬੋਰਡ ਦਾ ਲਾਗੂਕਰਨ ਐਂਡਪੌਇੰਟ (POST /api/cli-tools/apply) ਉਹੀ ਗਾਰਡ ਲਾਗੂ ਕਰਦਾ ਹੈ: ਕੰਟੇਨਰ ਵਿੱਚ, ਅਜਿਹੀ ਲਿਖਤ ਜਿਸਦਾ ਟਾਰਗੇਟ ਹੋਸਟ ਤੋਂ bind-mounted ਨਹੀਂ ਹੈ, 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/ਆਰਗੂਮੈਂਟ ਇੰਜੈਕਸ਼ਨ ਪਰਿਭਾਸ਼ਿਤ ਹੈ) 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 ਹੈ, ਉਹ ਕਸਟਮ ਬੇਸ 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 ਕਸਟਮ CLI — full custom-builder false

baseUrlSupport: "partial" ਵਾਲੇ ਟੂਲ ਡੈਸ਼ਬੋਰਡ ਕਾਰਡ ਵਿੱਚ "⚠ ਅੰਸ਼ਕ ਬੇਸ 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 ਤੋਂ ਬਦਲਿਆ ਗਿਆ ਹੈ) ਉਹ CLIs ਦਿਖਾਉਂਦਾ ਹੈ ਜਿਨ੍ਹਾਂ ਨੂੰ OmniRoute stdio/ACP ਪ੍ਰੋਟੋਕੋਲ ਰਾਹੀਂ ਬੈਕਐਂਡ ਐਗਜ਼ੀਕਿਊਸ਼ਨ ਇੰਜਣਾਂ ਵਜੋਂ ਸ਼ੁਰੂ ਕਰ ਸਕਦਾ ਹੈ। ਕੈਟਾਲਾਗ ਨੂੰ src/lib/acp/registry.ts ਵਿੱਚ ਵੱਖਰੇ ਤੌਰ 'ਤੇ ਸੰਭਾਲਿਆ ਜਾਂਦਾ ਹੈ ਅਤੇ ਇਹ CLI_TOOLS ਦੇ ਸਮਾਨ ਨਹੀਂ ਹੈ।

4. MITM ਬੈਕਲਾਗ (ਡੈਸ਼ਬੋਰਡ ਵਿੱਚ ਨਹੀਂ ਦਿਖਾਇਆ ਗਿਆ)

ਹੇਠਾਂ ਦਿੱਤੇ CLIs ਮੂਲ ਰੂਪ ਵਿੱਚ ਕਸਟਮ ਬੇਸ 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 ਦੀ ਸਮਾਂ-ਸੀਮਾ
  • ਕੈਸ਼: config ਫ਼ਾਈਲ ਦੇ 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 ਕੁੰਜੀ ਪ੍ਰਾਪਤ ਕਰੋ

  1. /dashboard/api-manager ਖੋਲ੍ਹੋ → API ਕੁੰਜੀ ਬਣਾਓ
  2. ਇਸਨੂੰ ਇੱਕ ਨਾਮ ਦਿਓ (ਜਿਵੇਂ cli-tools) ਅਤੇ ਸਾਰੀਆਂ ਇਜਾਜ਼ਤਾਂ ਚੁਣੋ
  3. ਕੁੰਜੀ ਕਾਪੀ ਕਰੋ — ਹੇਠਾਂ ਦਿੱਤੀ ਹਰ 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 ਕੋਡਿੰਗ ਏਜੰਟ
# ਇੰਸਟਾਲੇਸ਼ਨ ਲਈ 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 — ਗਲੋਬਲ ਇਨਵਾਇਰਨਮੈਂਟ ਵੇਰੀਏਬਲ ਸੈੱਟ ਕਰੋ

# 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 ਵੇਰੀਏਬਲਾਂ + ਫਲੈਗਾਂ ਨੂੰ ਪੜ੍ਹਦਾ ਹੈ)
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/ਨਾਮ/ਉਪਨਾਮ/ਸ਼੍ਰੇਣੀ ਅਨੁਸਾਰ ਫਿਲਟਰ ਕਰੋ
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 ਵਿਹਾਰ ਬਰਕਰਾਰ ਰੱਖਦੇ ਹਨ ਅਤੇ ਇਨ੍ਹਾਂ ਲਈ ਸਰਵਰ ਦਾ ਚੱਲਣਾ ਲਾਜ਼ਮੀ ਨਹੀਂ ਹੈ।

ਰਿਕਵਰੀ ਅਤੇ ਰੀਸੈੱਟ

omniroute reset-password                # ਐਡਮਿਨ ਪਾਸਵਰਡ ਰੀਸੈੱਟ ਕਰੋ (ਇਹ ਵੀ: omniroute-reset-password)
omniroute reset-encrypted-columns       # ਇਨਕ੍ਰਿਪਟ ਕੀਤੇ ਕਰੈਡੈਂਸ਼ੀਅਲ ਰੀਸੈੱਟ ਲਈ ਚੇਤਾਵਨੀ + ਡ੍ਰਾਈ-ਰਨ ਦਿਖਾਓ
omniroute reset-encrypted-columns --force  # SQLite ਵਿੱਚ ਇਨਕ੍ਰਿਪਟ ਕੀਤੇ ਕਰੈਡੈਂਸ਼ੀਅਲਾਂ ਨੂੰ ਅਸਲ ਵਿੱਚ null ਕਰੋ

ਕਰੈਡੈਂਸ਼ੀਅਲ ਐਕਸਪੋਰਟ (⚠ ਸਾਵਧਾਨੀ ਨਾਲ ਸੰਭਾਲੋ)

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 ਦਾ ਸੈੱਟ ਹੋਣਾ ਲਾਜ਼ਮੀ ਹੈ। ਜੇ ਕੋਈ ਫ਼ੀਲਡ ਡਿਕ੍ਰਿਪਟ ਹੋਣ ਵਿੱਚ ਅਸਫਲ ਰਹਿੰਦੀ ਹੈ (ਪੁਰਾਣੀ ਕੁੰਜੀ, ਖਰਾਬ ਸਾਈਫਰਟੈਕਸਟ), ਤਾਂ ਪੂਰੇ ਐਕਸਪੋਰਟ ਨੂੰ ਰੋਕਣ ਜਾਂ ਅਧਾਰਭੂਤ ਗਲਤੀ ਨੂੰ ਲੀਕ ਕਰਨ ਦੀ ਬਜਾਏ ਇਸਦੀ ਰਿਪੋਰਟ <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 ਸਰਵਰ ਵਜੋਂ ਚਲਾਓ (IDEs ਲਈ)
--non-interactive CI ਮੋਡ (ਕੋਈ ਪ੍ਰੌਂਪਟ ਨਹੀਂ; env/ਫਲੈਗਾਂ ਤੋਂ ਪੜ੍ਹਦਾ ਹੈ)
--json ਮਸ਼ੀਨ ਦੁਆਰਾ ਪੜ੍ਹਨਯੋਗ JSON ਆਉਟਪੁੱਟ (doctor, providers, ਆਦਿ)
--help, -h ਕਮਾਂਡ-ਵਿਸ਼ੇਸ਼ ਮਦਦ ਦਿਖਾਓ
--version, -v ਇੰਸਟਾਲ ਕੀਤਾ ਵਰਜਨ ਪ੍ਰਿੰਟ ਕਰੋ

ਉਪਲਬਧ API ਐਂਡਪੌਇੰਟ

ਐਂਡਪੌਇੰਟ ਵੇਰਵਾ ਵਰਤੋਂ ਲਈ
/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-69f4a4a-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 ਕੁੰਜੀ /dashboard/api-manager ਵਿੱਚ ਜਾਂਚ ਕਰੋ
No combo configured ਕੋਈ ਸਰਗਰਮ ਰੂਟਿੰਗ ਕੌਂਬੋ ਨਹੀਂ /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) ਵੱਲ ਆਪਣੇ ਆਪ ਰੀਡਾਇਰੈਕਟ ਕੀਤਾ ਜਾਂਦਾ ਹੈ
Reference in New Issue View Git Blame Copy Permalink