OmniRoute/docs/i18n/no/docs/reference/CLI-TOOLS.md

CLI-TOOLS (Norsk)

🌐 Languages: 🇺🇸 English · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇪🇸 es · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇳 gu · 🇮🇱 he · 🇮🇳 hi · 🇭🇺 hu · 🇮🇩 id · 🇮🇩 in · 🇮🇹 it · 🇯🇵 ja · 🇰🇷 ko · 🇮🇳 mr · 🇲🇾 ms · 🇳🇱 nl · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇸🇰 sk · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇻🇳 vi · 🇨🇳 zh-CN · 🇹🇼 zh-TW

---

---

title: "CLI-verktøy — OmniRoute" version: 3.8.50 lastUpdated: 2026-08-18

CLI-verktøy — OmniRoute

Sist oppdatert: 2026-08-18

OmniRoute integreres med tre kategorier av CLI-verktøy fordelt på tre dedikerte dashbord-sider:

Side	Rute	Konsept	Antall
CLI-kode	/dashboard/cli-code	Kodingverktøy du peker på OmniRoute (Klient → CLI → OmniRoute → Leverandør)	26
CLI-agenter	/dashboard/cli-agents	Autonome agenter du peker på OmniRoute (samme flyt, bredere omfang)	8
ACP-agenter	/dashboard/acp-agents	CLIs som OmniRoute genererer som backend via stdio/ACP (omvendt flyt)	se register

Legacy-ruter omdirigerer via 308: /dashboard/cli-tools → /dashboard/cli-code, /dashboard/agents → /dashboard/acp-agents.

---

Hvordan det fungerer

CLI-kode / CLI-agenter (forbruksflyt):
Claude / Codex / OpenCode / Cline / KiloCode / Continue / Hermes Agent / Goose / ...
           │
           ▼  (alle peker på OmniRoute)
    http://YOUR_SERVER:20128/v1
           │
           ▼  (OmniRoute ruter til riktig leverandør)
    Anthropic / OpenAI / Gemini / DeepSeek / Groq / Mistral / ...

ACP-agenter (omvendt genereringsflyt):
    Klientforespørsel → OmniRoute → genererer CLI via stdio/ACP → respons

Fordeler:

• Ett API-nøkkel for å administrere alle verktøy
• Kostnadssporing på tvers av alle CLIs i dashbordet
• Modellbytte uten å omkonfigurere hvert verktøy
• Fungerer lokalt og på eksterne servere (VPS, Docker, Akamai, Cloudflare Tunnel)

---

Auto-konfigurer med setup-*

Du trenger ikke å skrive hver verktøys konfigurasjon for hånd. OmniRoute leverer en setup-* kommando per støttet CLI som leser den live modellkatalogen fra en kjørende OmniRoute (lokal eller ekstern) og skriver verktøyets egen konfigurasjon på maskinen din:

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

Hver aksepterer --remote <url> --api-key <key> (konfigurer et lokalt verktøy mot en ekstern OmniRoute), --dry-run (forhåndsvisning uten skriving), og --port. Verktøy uten modell auto-oppsporing (Cline, Kilo, Roo, Goose, Aider, Qwen) tar --model <id> (og --yes for ikke-interaktive kjøringer). For å starte en CLI med riktig miljø injisert og ingen konfigurasjon skrevet i det hele tatt, bruk den generiske omniroute run <target> launcher (claude, codex, aider, goose, opencode, qwen, gemini — mål og aliaser kommer fra bin/cli/cli-manifest.mjs); de legacy per-verktøy launcherne omniroute launch (Claude Code) og omniroute launch-codex (Codex) forblir tilgjengelige. Gemini CLI er kun for oppstart: det er et omniroute run mål, men har ingen setup-*/configure oppskrift.

Full referanse: hovedtabellen — hva hver kommando skriver, hver flagg, lokal vs ekstern, og hvilke verktøy som ønsker en /v1 suffiks — finnes i CLI-integrasjoner.

Kjøring av disse inne i en container

En setup-* kommando utført inne i OmniRoute-containeren skriver inn i containerens egen hjem, som ingen vert-CLI leser og som forsvinner med containeren. OmniRoute oppdager dette og avslutter med 2 med instruksjoner i stedet for å skrive. To støttede måter videre — installer CLI på verten og omniroute connect til containeren, eller bind-mount konfigurasjonskatalogene og sett CLI_CONFIG_HOME (compose host profil). Hver setup-* kommando, pluss omniroute configure og omniroute config set, aksepterer --allow-container-write når konfigurasjon av containerens egne CLIs er det du faktisk mente; OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE=true gjør det samme for serveren. Se Docker Guide → Konfigurere vert-CLI-verktøy.

Dashbordets apply-endepunkt (POST /api/cli-tools/apply) håndhever den samme beskyttelsen: i en container, en skriving hvis mål ikke er bind-mountet fra vertsystemet svarer 422 med containerEphemeralTarget: true, den trygge feilmeldingen og — for verktøyene med en vert-oppskrift (claude, codex, opencode, cline, kilo, continue) — en hostSetupCommand (f.eks. omniroute setup-opencode) som skal kjøres på verten i stedet; ingenting skrives. dryRun: true fortsetter å fungere i container modus og returnerer det genererte innholdet + målsti uten å berøre disken, så du kan forhåndsvise fra dashbordet og bruke på verten. Denne oppførselen er intensjonell og regresjonsbeskyttet av tests/unit/api/cli-tools/apply-container-guard.test.ts — aldri "fikse" en 422 ved å fjerne beskyttelsen.

---

Kilde til sannhet

Den enhetlige katalogen finnes i src/shared/constants/cliTools.ts som CLI_TOOLS: Record<string, CliCatalogEntry>.

Hver oppføring har disse feltene (definert i src/shared/schemas/cliCatalog.ts):

Felt	Type	Beskrivelse
category	"code" | "agent"	Hvilken side verktøyet vises på
vendor	string	Verktøyets opprinnelse ("Anthropic", "OSS (P. Gauthier)")
acpSpawnable	boolean	Også brukbar som en ACP Agent (merke vist)
baseUrlSupport	"full" | "partial" | "none"	Tilpasset endepunkt støtte nivå. "none" = MITM backlog
configType	"env" | "custom" | "guide" | "custom-builder" | "mitm"	Konfigurasjonsmekanisme
id, name, color, description, docsUrl	standard	Kjerne visningsfelt

Oppføringer med baseUrlSupport: "none" vises ikke på dashbordsidene — de er registrert i MITM backlog for plan 11 (se _tasks/features-v3.8.6/refactorpages/_orchestration/_plan11-mitm-backlog.md).

Kapabilitetsnivåer (katalogisert × oppdagbar × konfigurerbar × lanserbar)

Ikke hvert katalogisert verktøy er oppdagbart, konfigurerbart eller lanserbart. Hvert nivå har en deklarerende kilde, og en driftstest holder dem synkronisert:

Nivå	Betydning	Deklarert i
Katalogisert	Visas i dashbordkatalogen (navn, leverandør, dokumentasjon, konfigurasjonstype)	src/shared/constants/cliTools.ts (CLI_TOOLS)
Oppdagbar	Binær-/konfigurasjonsdeteksjon, helsesjekker, konfigurasjonsstier	src/shared/services/cliRuntime.ts (CLI_TOOLS runtime katalog)
Konfigurerbar	Støttet av omniroute configure <cli> (oppskriftsoppsett eksisterer)	bin/cli/cli-manifest.mjs (configure: true)
Lanserbar	Støttet av omniroute run <target> (miljø/argumentinjeksjon definert)	bin/cli/cli-manifest.mjs (run: true)

bin/cli/cli-manifest.mjs er det kanoniske kjørbare manifestet for CLI-kommandoene overflater: run, configure og shell-fullføringsgeneratorene henter alle sine mål lister, aliasoppløsning (for eksempel kilocode/kilo-code/kilo_cli → kilo) og --model flagg kabling fra det. Driftbeskyttelsen tests/unit/cli/cli-manifest-drift.test.ts bekrefter at manifestet, runtime katalogen, UI-katalogen og hver forbrukeroverflate forblir synkronisert — et mål lagt til én overflate uten de andre feiler testen i stedet for å drive stille.

1. Katalog over CLI-kode (26 verktøy)

Alle verktøy som vises i /dashboard/cli-code. De med baseUrlSupport: none er koblet gjennom MITM eller en manuell guide i stedet for en tilpasset base-URL:

id	navn	leverandør	baseUrlSupport	configType	acpSpawnable
claude	Claude Code	Anthropic	full	env	true
codex	OpenAI Codex CLI	OpenAI	full	custom	true
zcode	ZCode (GLM Coding Plan)	Z.ai	none	custom	false
cline	Cline	OSS (ex-Claude Dev)	full	custom	true
kilo	Kilo Code	Kilo-Org	full	custom	false
roo	Roo Code	Roo (OSS)	full	guide	false
continue	Continue	continue.dev	full	guide	false
aider	Aider	OSS (P. Gauthier)	full	guide	true
forge	ForgeCode	Antinomy HQ	full	custom	true
jcode	jcode	1jehuang (OSS)	full	custom	false
deepseek-tui	DeepSeek TUI	Hunter Bown (OSS)	full	custom	false
codewhale	CodeWhale	Hmbown (OSS)	full	custom	false
opencode	OpenCode	Anomaly (ex-SST)	full	guide	true
droid	Factory Droid	Factory AI	partial	guide	false
copilot	GitHub Copilot CLI	GitHub/MS	full	custom	false
cursor-cli	Cursor CLI	Anysphere	partial	guide	true
smelt	Smelt	leonardcser (OSS)	full	custom	false
pi	Pi (pi-coding-agent)	M. Zechner (OSS)	full	custom	false
grok-build	Grok Build	xAI	full	custom	false
crush	Crush	OSS (Charm)	full	custom	false
qwen	Qwen Code	Alibaba	full	guide	true
cursor	Cursor	Anysphere	none	guide	false
antigravity	Antigravity	Google	none	mitm	false
hermes	Hermes	Nous Research	none	guide	false
kiro	Kiro AI	Amazon	none	mitm	false
custom	Custom CLI	—	full	custom-builder	false

Verktøy med baseUrlSupport: "partial" viser et merke "⚠ Base URL parcial" i dashboard-kortet.

2. CLI Agenter Katalog (8 verktøy)

Autonome agenter som vises i /dashboard/cli-agents:

id	navn	leverandør	baseUrlSupport	acpSpawnable
hermes-agent	Hermes Agent	Nous Research	full	false
openclaw	OpenClaw	OSS (P. Steinberger)	full	true
goose	Goose	Block / Linux Foundation	full	true
interpreter	Open Interpreter	OSS	full	true
warp	Warp AI	Warp Inc.	partial	true
agent-deck	Agent Deck	asheshgoplani (OSS)	full	false
omp	Oh My Pi	OSS	full	true
letta	Letta CLI	Letta	full	false

---

3. ACP Agenter (/dashboard/acp-agents)

Denne siden (omdøpt fra /dashboard/agents) viser CLI-er som OmniRoute kan spawne som backend utførelsesmotorer via stdio/ACP-protokollen. Katalogen vedlikeholdes separat i src/lib/acp/registry.ts og er ikke den samme som CLI_TOOLS.

---

4. MITM Backlog (ikke vist i dashbordet)

Følgende CLI-er støtter ikke tilpasset base-URL nativt og er ikke oppført på CLI-kode- eller CLI-agenter-sidene. De er kandidater for MITM-intervensjon i plan 11:

CLI	Årsak
windsurf	BYOK begrenset til utvalgte Claude-modeller + bedrifts-URL/token
amp	Lukket økosystem (Sourcegraph)
amazon-q / kiro-cli	AWS SSO autentisering, ingen tilpasset URL
cowork	Anthropic Desktop, ingen konfigurerbar endepunkt

Se _tasks/features-v3.8.6/refactorpages/_orchestration/_plan11-mitm-backlog.md for full kryssreferanse.

---

5. Batch Deteksjon API

All verktøydeteksjon er aggregert via et enkelt endepunkt:

GET /api/cli-tools/all-statuses

• Auth: requireCliToolsAuth(request) (samme som andre /api/cli-tools/ ruter)
• Returnerer: Record<toolId, ToolBatchStatus> (type: src/shared/types/cliBatchStatus.ts)
• Strategi: Promise.all over alle verktøy, 5s tidsavbrudd per verktøy
• Cache: i minnet LRU indeksert av konfigurasjonsfil mtime. Cache ugyldiggjøres når mtime endres. Tilbakestilles ved serveromstart.

Responsform per verktøy:

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; // sanitert, ingen stakkspor
}

6. Innstillinger for nye verktøy

Nye verktøy med configType: "custom" har dedikerte innstillings-API-ruter:

Rute	Verktøy
POST /api/cli-tools/forge-settings	ForgeCode (.forge.toml)
POST /api/cli-tools/jcode-settings	jcode (--base-url flag)
POST /api/cli-tools/deepseek-tui-settings	DeepSeek TUI (OPENAI_BASE_URL, legacy)
POST /api/cli-tools/codewhale-settings	CodeWhale (OPENAI_BASE_URL, primær + legacy ~/.deepseek synk)
POST /api/cli-tools/smelt-settings	Smelt
POST /api/cli-tools/pi-settings	Pi coding agent
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 + dedikert .env nøkkel)

Alle ruter bruker sanitizeErrorMessage() for feilmeldinger (Hard Rule #12).

---

7. Arkitektur for dashbord-sider

CLI-kode (/dashboard/cli-code)

• src/app/(dashboard)/dashboard/cli-code/page.tsx — serverkomponent
• src/app/(dashboard)/dashboard/cli-code/CliCodePageClient.tsx — klientgrid
• src/app/(dashboard)/dashboard/cli-code/[id]/page.tsx — verktøydetaljside
• src/app/(dashboard)/dashboard/cli-code/components/ — 12 spesialiserte verktøykort + ToolDetailClient.tsx

CLI-agenter (/dashboard/cli-agents)

• src/app/(dashboard)/dashboard/cli-agents/page.tsx — serverkomponent
• src/app/(dashboard)/dashboard/cli-agents/CliAgentsPageClient.tsx — klientgrid
• src/app/(dashboard)/dashboard/cli-agents/[id]/page.tsx — gjenbruker ToolDetailClient

ACP-agenter (/dashboard/acp-agents)

• src/app/(dashboard)/dashboard/acp-agents/page.tsx — serverkomponent (flyttet fra agents/)

Delte UI-komponenter (src/shared/components/cli/)

Fil	Formål
CliToolCard.tsx	Smart statuskort (deteksjon + konfig + endepunkt)
CliConceptCard.tsx	Forklaringskort for konsept per side
CliComparisonCard.tsx	Sammenligning i tre kolonner på tvers av CLI-typer
BaseUrlSelect.tsx	Endepunkt nedtrekksmeny (Lokal/Cloud/Custom)
ApiKeySelect.tsx	API-nøkkelvelger
ManualConfigModal.tsx	Kopierbar konfigurasjonsutdrag modal

Delt Hook (src/shared/hooks/cli/)

Fil	Formål
useToolBatchStatuses.ts	Henter /api/cli-tools/all-statuses, håndterer lasting/oppdateringstilstand

8. i18n

Nye navnerom lagt til i plan 14 F9:

Navnerom	Formål
cliCommon	Delte strenger (kortetiketter, konsept/sammenligningstekster, detaljsideetiketter)
cliCode	Strenger for CLI-kode siden
cliAgents	Strenger for CLI-agenter siden
acpAgents	Strenger for ACP-agenter siden

Full PT-BR og EN oversettelser er tilgjengelige. 39 andre lokaliteter faller automatisk tilbake til EN via navneromsnivå sammenslåing i src/i18n/request.ts.

---

9. Hurtigstart

Trinn 1 — Få en OmniRoute API-nøkkel

1. Åpne /dashboard/api-manager → Opprett API-nøkkel
2. Gi den et navn (f.eks. cli-tools) og velg alle tillatelser
3. Kopier nøkkelen — du trenger den for hver CLI nedenfor

Nøkkelen din ser slik ut: sk-xxxxxxxxxxxxxxxx-xxxxxxxxx

---

Trinn 2 — Installer CLI-verktøy

Alle npm-baserte verktøy krever Node.js 22.22.2+ eller 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 (kan startes via `omniroute run gemini` → /v1beta surface)
npm install -g @google/gemini-cli

# Aider
pip install aider-chat

# Smelt
cargo install smelt  # Rust-basert

# Pi coding agent
# se https://github.com/zechnerj/pi-coding-agent for installasjon

# jcode
# se https://github.com/1jehuang/jcode for installasjon

---

Trinn 3 — Konfigurer via Dashboard

1. Gå til http://localhost:20128/dashboard/cli-code
2. Finn verktøyet ditt i rutenettet
3. Klikk på kortet for å åpne verktøyets detaljside
4. Velg API-nøkkelen din og basis-URL
5. Klikk Bruk konfigurasjon eller kopier den manuelle konfigurasjonsbiten

---

Trinn 4 — Sett globale miljøvariabler

# OmniRoute Universal Endpoint
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 leser GOOGLE_GEMINI_BASE_URL på ROT (SDK-en legger selv til /v1beta/...)
export GOOGLE_GEMINI_BASE_URL="http://localhost:20128"
export GEMINI_API_KEY="sk-your-omniroute-key"

For en fjerntjener erstatt localhost:20128 med serverens IP eller domene, f.eks. http://<your-server-ip>:20128.

---

Trinn 4 — Konfigurer hvert verktøy

Claude Code

# Opprett ~/.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

Bruk den enhetlige Anthropic gateway-roten for Claude Code. Ikke legg til /v1 her.

Test: claude "say hello"

---

OpenAI Codex

Moderne Codex (v0.137+) leser ~/.codex/config.toml kun — den gamle config.yaml tilhører den eldre npm CLI og blir stille ignorert. API-nøkkelen forblir i miljøvariabelen OMNIROUTE_API_KEY (env_key), aldri inni filen:

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"

Full referanse (profiler, wire_api, kontekstvinduer): CODEX-CLI-CONFIGURATION.md.

Test: 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

Test: opencode

Bruk opencode run "your prompt" --model omniroute/claude-sonnet-4-5-thinking --variant high for å sende tenkevarianter.

---

Cline (CLI eller VS Code)

CLI-modus:

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-modus: Cline-utvidelsens innstillinger → API-leverandør: OpenAI Compatible → Basis-URL: http://localhost:20128/v1

Eller bruk OmniRoute-dashboardet → CLI-verktøy → Cline → Bruk konfigurasjon.

---

KiloCode (CLI eller VS Code)

CLI-modus:

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

VS Code-innstillinger:

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

Eller bruk OmniRoute-dashboardet → CLI-verktøy → KiloCode → Bruk konfigurasjon.

---

Continue (VS Code-utvidelse)

Rediger ~/.continue/config.yaml:

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

Start VS Code på nytt etter redigering.

---

VS Code Insiders (chatLanguageModels.json)

Bruk dette når VS Code Insiders er konfigurert for tilpassede endepunktmodeller og du vil at OmniRoute skal fungere uten et tilpasset headerfelt.

Anbefalt plassering:

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

Eksempel som bruker den tokeniserte OmniRoute-aliasen:

[
  {
    "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"
    }
  }
]

Notater:

• Erstatt sk-your-omniroute-key med en API-nøkkel opprettet i OmniRoute.
• url-feltet skal peke til /api/v1/vscode/{token}/chat/completions.
• modelsUrl-feltet skal peke til /api/v1/vscode/{token}/models.
• Foretrekk den normale /v1 + Bearer header-flyten når klienten støtter tilpassede overskrifter.
• URL-innlemmede tokens er en kompatibilitetsfall tilbake og kan vises i redigeringslogger eller proxyhistorikk.

---

Kiro CLI (Amazon)

# Logg inn på din AWS/Kiro-konto:
kiro-cli login

# CLI bruker sin egen autentisering — OmniRoute er ikke nødvendig som backend for Kiro CLI selv.
# Bruk kiro-cli sammen med OmniRoute for andre verktøy.
kiro-cli status

For Kiro IDE skrivebordsapp, bruk MITM-endepunktet som er eksponert av OmniRoute under /dashboard/cli-tools → Kiro.

---

10. Intern OmniRoute CLI

Den omniroute binæren gir kommandoer for serverlivssyklus, oppsett, diagnostikk og leverandøradministrasjon. Inngangspunkt: bin/omniroute.mjs.

omniroute                              # Start server (standard port 20128)
omniroute setup                        # Interaktiv oppsettsveiviser
omniroute doctor                       # Sjekk konfigurasjon, DB, porter, kjøring
omniroute providers list               # Konfigurerte leverandørforbindelser
omniroute providers test-all           # Test hver aktiv forbindelse
omniroute reset-password               # Tilbakestill adminpassord
omniroute logs                         # Strøm forespørsel logger
omniroute health                       # Detaljert helse (brytere, cache, minne)
omniroute --version                    # Skriv ut versjon
omniroute --help                       # Vis alle kommandoer

Oppsett og initialisering

omniroute setup                        # Interaktiv oppsettsveiviser
omniroute setup --non-interactive      # CI/automatiseringsmodus (leser miljøvariabler + flagg)
omniroute setup --password '<verdi>'   # Sett adminpassord direkte
omniroute setup --add-provider \
  --provider openai \
  --api-key '<verdi>' \
  --test-provider                      # Legg til og test en leverandør i ett steg

Gjenkjente miljøvariabler for ikke-interaktivt oppsett:

Var	Formål
OMNIROUTE_API_KEY	Leverandør API-nøkkel (bundet til --api-key via Commander .env())
DATA_DIR	Overstyr OmniRoute datakatalogen

Alle andre ikke-interaktive innganger sendes som flagg, ikke miljøvariabler: --password, --provider, --provider-name, --provider-base-url, --default-model (se omniroute setup alternativer ovenfor).

Diagnostikk

omniroute doctor                       # Sjekk konfigurasjon, DB, porter, kjøring, minne, livlighet
omniroute doctor --json                # Maskinlesbar JSON
omniroute doctor --no-liveness         # Hopp over HTTP helseundersøkelse
omniroute doctor --host 0.0.0.0        # Overstyr livlighet vert
omniroute doctor --liveness-url <url>  # Full helseendepunkt URL-overstyring

Doktoren kjører disse sjekkene: Konfigurasjon, Database, Lagring/kryptering, Port tilgjengelighet, Node kjøring, Native binær (better-sqlite3), Minne, og Server livlighet. Den avslutter med ikke-null hvis noen sjekk er feil.

Leverandøradministrasjon

omniroute providers available                       # OmniRoute leverandørkatalog
omniroute providers available --search openai       # Filtrer katalog etter id/navn/alias/kategori
omniroute providers available --category api-key    # Filtrer etter kategori (api-key, oauth, gratis, ...)
omniroute providers available --json                # Maskinlesbar JSON

omniroute providers list                            # Konfigurerte leverandørforbindelser
omniroute providers list --json

omniroute providers test <id|navn>                  # Test en konfigurert forbindelse
omniroute providers test-all                        # Test hver aktiv forbindelse
omniroute providers validate                        # Lokalt strukturell validering
omniroute providers add <leverandør> --credential-env PROVIDER_KEY
omniroute providers import ./providers.json --dry-run --json
omniroute providers auth <leverandør>                 # Eksisterende OAuth flyt
omniroute providers edit <id|navn> --default-model <modell>
omniroute providers remove <id|navn> --yes

providers add/import/auth/edit/remove er API-først og fungerer derfor mot den aktive lokale eller eksterne konteksten. Credential-inngang bør bruke --credential-stdin eller --credential-env; --dry-run --json rapporterer kun redigert tilstedeværelse/form. providers available leser OmniRoute katalogen; providers list/test/test-all/validate beholder sin lokale SQLite-atferd og krever ikke at serveren kjører.

Gjenoppretting og tilbakestilling

omniroute reset-password                # Tilbakestill adminpassord (også: omniroute-reset-password)
omniroute reset-encrypted-columns       # Vis advarsel + tørrkjøring for tilbakestilling av krypterte legitimasjoner
omniroute reset-encrypted-columns --force  # Faktisk nullstill krypterte legitimasjoner i SQLite

Eksport av legitimasjoner (⚠ håndter med forsiktighet)

omniroute auth export                                 # Vis advarsel + bekreftelsesport — ingen DB-tilgang
omniroute auth export --force                          # Eksporter ALLE forbindelsers DEKRYPTERTE legitimasjoner til stdout som JSON
omniroute auth export --force --id <id>                 # Eksporter kun den matchende forbindelsen
omniroute auth export --force --format env               # Emit OMNIROUTE_<LEVERANDØR>_<FELT>=<verdi> linjer
omniroute auth export --force --out creds.json           # Skriv til en fil (opprettet med 0600 tillatelser)

auth export er lokal-only (direkte SQLite lesing, ingen HTTP-rute) og skriver med vilje ren tekst apiKey/accessToken/refreshToken/idToken verdier — det er funksjonen, ikke en bug. Ingenting leses fra databasen, og ingenting dekrypteres, uten --force. En stderr advarsel banner skrives alltid ut før noen ren tekst sendes. Krever STORAGE_ENCRYPTION_KEY å være satt. Et felt som mislykkes i dekryptering (utdatert nøkkel, ødelagt ciphertext) rapporteres som <felt>DecryptFailed: true i stedet for å avbryte hele eksporten eller lekke den underliggende feilen.

Andre underkommandoer

Disse forutsetter en kjørende OmniRoute-server, med mindre annet er notert:

omniroute status                       # Omfattende kjøretidsstatus
omniroute logs                         # Strøm forespørsel logger (--json, --search, --follow)
omniroute config show                  # Vis nåværende konfigurasjon

omniroute provider list                # List tilgjengelige leverandører (alias av providers list)
omniroute provider add                 # Registrer OmniRoute som en leverandør på et verktøy
omniroute keys add | list | remove     # Administrer API-nøkler
omniroute models [leverandør]            # List modeller (--json, --search)
omniroute combo list | switch | create | delete

omniroute backup                       # Snapshot konfig + DB
omniroute restore                      # Gjenopprett fra et tidligere snapshot

omniroute health                       # Detaljert helse (brytere, cache, minne)
omniroute quota                        # Leverandør kvote bruk
omniroute cache                        # Cache status
omniroute cache clear                  # Tøm semantiske + signatur cacher

omniroute mcp status | restart         # MCP server status / restart
omniroute a2a status | card            # A2A server status / agent kort

omniroute tunnel list | create | stop  # Administrer tunneler (cloudflare/tailscale/ngrok)
omniroute env show | get <k> | set <k> <v>  # Inspiser / sett miljøvariabler (midlertidig)

omniroute test                         # Leverandør tilkoblings røyk test
omniroute update                       # Sjekk for oppdateringer
omniroute completion                   # Generer skall fullføring

Vanlige flagg

Flag	Beskrivelse
--no-open	Ikke auto-åpne nettleseren ved start
--port <n>	Overstyr API-porten (standard 20128)
--mcp	Kjør som MCP-server over stdio (for IDE-er)
--non-interactive	CI-modus (ingen spørsmål; leser fra miljø/flag)
--json	Maskinlesbar JSON-utgang (doctor, providers, osv.)
--help, -h	Vis kommando-spesifikk hjelp
--version, -v	Skriv ut installert versjon

Tilgjengelige API-endepunkter

Endepunkt	Beskrivelse	Bruk For
/v1/chat/completions	Standard chat (alle leverandører)	Alle moderne verktøy
/v1/responses	Respons API (OpenAI-format)	Codex, agentiske arbeidsflyter
/v1/completions	Legacy tekstfullføringer	Eldre verktøy som bruker prompt:
/v1/embeddings	Tekstinnbøyninger	RAG, søk
/v1/images/generations	Bildegenerering	GPT-Image, Flux, osv.
/v1/audio/speech	Tekst-til-tale	ElevenLabs, OpenAI TTS
/v1/audio/transcriptions	Tale-til-tekst	Deepgram, AssemblyAI

Klar-til-å-lime eksempler med en tokenisert OmniRoute-URL:

Token eksempel: sk-a3ab3c080beaee3a-69f4a4-070d71af

Standard OpenAI base: http://localhost:20128/v1
VS Code modeller: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/models
VS Code chat: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/chat/completions
VS Code responser: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/responses
Ollama tags: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/api/tags
Ollama chat: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/api/chat

---

Feilsøking

Feil	Årsak	Løsning
Connection refused	OmniRoute kjører ikke	omniroute serve
401 Unauthorized	Feil API-nøkkel	Sjekk i /dashboard/api-manager
No combo configured	Ingen aktiv rutingkombinasjon	Sett opp i /dashboard/combos
CLI viser "not installed"	Binær ikke i PATH	Sjekk which <command>
Dashboard viser "not detected" etter installasjon	Cache utdaterte	Klikk "⟳ Oppdater deteksjon" i dashbordet
Gammel lenke /dashboard/cli-tools	Bokmerke før v3.8.6	Automatisk omdirigert til /dashboard/cli-code (308)
Gammel lenke /dashboard/agents	Bokmerke før v3.8.6	Automatisk omdirigert til /dashboard/acp-agents (308)