Skip to content

CLI-TOOLS.md

Latest commit

 

History

History
760 lines (566 loc) · 60.2 KB

CLI-TOOLS.md

File metadata and controls

760 lines (566 loc) · 60.2 KB
Raw

CLI Tools — OmniRoute (ਪੰਜਾਬੀ)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 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

ਆਖਰੀ ਅੱਪਡੇਟ: 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 ਉਹ 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 ਦੇ ਅਧੀਨ ਨਹੀਂ ਲਿਖਦੀ: ਇਹ ਫਲੀਟ ਹੋਸਟ 'ਤੇ ਇੱਕ ਰੂਟ-ਮਾਲਕੀਅਤ ਵਾਲੀ ਪ੍ਰਮਾਣਿਕਤਾ ਪ੍ਰੋਫਾਈਲ ਲਿਖ ਕੇ ਇੱਕ 5dive ਏਜੰਟ ਫਲੀਟ ਨੂੰ ਸੰਰਚਿਤ ਕਰਦੀ ਹੈ, ਇਸਲਈ ਇਹ sudo ਦੁਆਰਾ ਮੁੜ-ਐਗਜ਼ੀਕਿਊਟ ਕਰਦੀ ਹੈ ਅਤੇ ਇਸਦਾ ਆਪਣਾ ਕੋਈ ਰਿਮੋਟ ਮੋਡ ਨਹੀਂ ਹੈ। ਸਹੀ ਵਾਤਾਵਰਣ ਇੰਜੈਕਟ ਕੀਤੇ ਅਤੇ ਬਿਨਾਂ ਕਿਸੇ ਸੰਰਚਨਾ ਦੇ ਲਿਖੇ ਇੱਕ 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 ਵਿੱਚ ਮੌਜੂਦ ਹੈ।

ਇਹਨਾਂ ਨੂੰ ਇੱਕ ਕੰਟੇਨਰ ਦੇ ਅੰਦਰ ਚਲਾਉਣਾ

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 ਦੇਖੋ।

ਡੈਸ਼ਬੋਰਡ ਦਾ ਅਪਲਾਈ ਐਂਡਪੁਆਇੰਟ (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 ਦੇਖੋ। ਇਹ ਵਿਵਹਾਰ ਜਾਣਬੁੱਝ ਕੇ ਹੈ ਅਤੇ 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 vars + ਫਲੈਗ ਪੜ੍ਹਦਾ ਹੈ)
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 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 ਸਰਵਰ ਵਜੋਂ ਚਲਾਓ (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) ਵੱਲ ਆਪਣੇ ਆਪ ਰੀਡਾਇਰੈਕਟ ਕੀਤਾ ਜਾਂਦਾ ਹੈ