# CLI Tools — OmniRoute (ქართული)

🌐 **Languages:** 🇺🇸 [English](../../../../reference/CLI-TOOLS.md) · 🇪🇹 [am](../../../am/docs/reference/CLI-TOOLS.md) · 🇸🇦 [ar](../../../ar/docs/reference/CLI-TOOLS.md) · 🇦🇿 [az](../../../az/docs/reference/CLI-TOOLS.md) · 🇧🇬 [bg](../../../bg/docs/reference/CLI-TOOLS.md) · 🇧🇩 [bn](../../../bn/docs/reference/CLI-TOOLS.md) · 🇧🇦 [bs](../../../bs/docs/reference/CLI-TOOLS.md) · 🇨🇿 [cs](../../../cs/docs/reference/CLI-TOOLS.md) · 🇩🇰 [da](../../../da/docs/reference/CLI-TOOLS.md) · 🇩🇪 [de](../../../de/docs/reference/CLI-TOOLS.md) · 🇬🇷 [el](../../../el/docs/reference/CLI-TOOLS.md) · 🇪🇸 [es](../../../es/docs/reference/CLI-TOOLS.md) · 🇪🇪 [et](../../../et/docs/reference/CLI-TOOLS.md) · 🇮🇷 [fa](../../../fa/docs/reference/CLI-TOOLS.md) · 🇫🇮 [fi](../../../fi/docs/reference/CLI-TOOLS.md) · 🇫🇷 [fr](../../../fr/docs/reference/CLI-TOOLS.md) · 🇮🇪 [ga](../../../ga/docs/reference/CLI-TOOLS.md) · 🇮🇳 [gu](../../../gu/docs/reference/CLI-TOOLS.md) · 🇳🇬 [ha](../../../ha/docs/reference/CLI-TOOLS.md) · 🇮🇱 [he](../../../he/docs/reference/CLI-TOOLS.md) · 🇮🇳 [hi](../../../hi/docs/reference/CLI-TOOLS.md) · 🇭🇷 [hr](../../../hr/docs/reference/CLI-TOOLS.md) · 🇭🇺 [hu](../../../hu/docs/reference/CLI-TOOLS.md) · 🇦🇲 [hy](../../../hy/docs/reference/CLI-TOOLS.md) · 🇮🇩 [id](../../../id/docs/reference/CLI-TOOLS.md) · 🇳🇬 [ig](../../../ig/docs/reference/CLI-TOOLS.md) · 🇮🇹 [it](../../../it/docs/reference/CLI-TOOLS.md) · 🇯🇵 [ja](../../../ja/docs/reference/CLI-TOOLS.md) · 🇰🇭 [km](../../../km/docs/reference/CLI-TOOLS.md) · 🇮🇳 [kn](../../../kn/docs/reference/CLI-TOOLS.md) · 🇰🇷 [ko](../../../ko/docs/reference/CLI-TOOLS.md) · 🇱🇹 [lt](../../../lt/docs/reference/CLI-TOOLS.md) · 🇱🇻 [lv](../../../lv/docs/reference/CLI-TOOLS.md) · 🇮🇳 [ml](../../../ml/docs/reference/CLI-TOOLS.md) · 🇮🇳 [mr](../../../mr/docs/reference/CLI-TOOLS.md) · 🇲🇾 [ms](../../../ms/docs/reference/CLI-TOOLS.md) · 🇲🇹 [mt](../../../mt/docs/reference/CLI-TOOLS.md) · 🇲🇲 [my](../../../my/docs/reference/CLI-TOOLS.md) · 🇳🇵 [ne](../../../ne/docs/reference/CLI-TOOLS.md) · 🇳🇱 [nl](../../../nl/docs/reference/CLI-TOOLS.md) · 🇳🇴 [no](../../../no/docs/reference/CLI-TOOLS.md) · 🇮🇳 [or](../../../or/docs/reference/CLI-TOOLS.md) · 🇮🇳 [pa](../../../pa/docs/reference/CLI-TOOLS.md) · 🇵🇭 [phi](../../../phi/docs/reference/CLI-TOOLS.md) · 🇵🇱 [pl](../../../pl/docs/reference/CLI-TOOLS.md) · 🇵🇹 [pt](../../../pt/docs/reference/CLI-TOOLS.md) · 🇧🇷 [pt-BR](../../../pt-BR/docs/reference/CLI-TOOLS.md) · 🇷🇴 [ro](../../../ro/docs/reference/CLI-TOOLS.md) · 🇷🇺 [ru](../../../ru/docs/reference/CLI-TOOLS.md) · 🇱🇰 [si](../../../si/docs/reference/CLI-TOOLS.md) · 🇸🇰 [sk](../../../sk/docs/reference/CLI-TOOLS.md) · 🇸🇮 [sl](../../../sl/docs/reference/CLI-TOOLS.md) · 🇷🇸 [sr](../../../sr/docs/reference/CLI-TOOLS.md) · 🇸🇪 [sv](../../../sv/docs/reference/CLI-TOOLS.md) · 🇰🇪 [sw](../../../sw/docs/reference/CLI-TOOLS.md) · 🇮🇳 [ta](../../../ta/docs/reference/CLI-TOOLS.md) · 🇮🇳 [te](../../../te/docs/reference/CLI-TOOLS.md) · 🇹🇭 [th](../../../th/docs/reference/CLI-TOOLS.md) · 🇹🇷 [tr](../../../tr/docs/reference/CLI-TOOLS.md) · 🇺🇦 [uk-UA](../../../uk-UA/docs/reference/CLI-TOOLS.md) · 🇵🇰 [ur](../../../ur/docs/reference/CLI-TOOLS.md) · 🇺🇿 [uz](../../../uz/docs/reference/CLI-TOOLS.md) · 🇻🇳 [vi](../../../vi/docs/reference/CLI-TOOLS.md) · 🇳🇬 [yo](../../../yo/docs/reference/CLI-TOOLS.md) · 🇨🇳 [zh-CN](../../../zh-CN/docs/reference/CLI-TOOLS.md) · 🇹🇼 [zh-TW](../../../zh-TW/docs/reference/CLI-TOOLS.md)

---

ბოლო განახლება: 2026-08-23

OmniRoute ინტეგრირდება სამი კატეგორიის CLI ხელსაწყოებთან, რომლებიც განაწილებულია დაფის სამ სპეციალურ გვერდზე:

| გვერდი           | მარშრუტი                | კონცეფცია                                                                                          | რაოდენობა      |
| ---------------- | ----------------------- | -------------------------------------------------------------------------------------------------- | -------------- |
| **CLI კოდები**   | `/dashboard/cli-code`   | კოდირების ხელსაწყოები, რომლებსაც OmniRoute-ზე მიუთითებთ (კლიენტი → CLI → OmniRoute → პროვაიდერი)   | 26             |
| **CLI აგენტები** | `/dashboard/cli-agents` | ავტონომიური აგენტები, რომლებსაც OmniRoute-ზე მიუთითებთ (იგივე ნაკადი, უფრო ფართო მოქმედების სფერო) | 10             |
| **ACP აგენტები** | `/dashboard/acp-agents` | CLI-ები, რომლებსაც OmniRoute უშვებს backend-ის სახით stdio/ACP-ის მეშვეობით (შებრუნებული ნაკადი)   | იხილეთ რეესტრი |

მოძველებული მარშრუტები 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 → უშვებს CLI-ს stdio/ACP-ის მეშვეობით → პასუხი
```

**უპირატესობები:**

- ერთი API გასაღები ყველა ინსტრუმენტის სამართავად
- ხარჯების თვალყურის დევნება ყველა CLI-სთვის დაფაზე
- მოდელების გადართვა თითოეული ინსტრუმენტის ხელახლა კონფიგურირების გარეშე
- მუშაობს როგორც ლოკალურად, ისე დისტანციურ სერვერებზე (VPS, Docker, Akamai, Cloudflare Tunnel)

---

## ავტომატური კონფიგურაცია `setup-*`-ით

თქვენ არ გჭირდებათ თითოეული ხელსაწყოს კონფიგურაციის ხელით დაწერა. OmniRoute-ს მოყვება `setup-*` ბრძანება თითოეული მხარდაჭერილი CLI-სთვის, რომელიც კითხულობს **ცოცხალ** მოდელის კატალოგს გაშვებული OmniRoute-დან (ლოკალური ან დისტანციური) და წერს ხელსაწყოს საკუთარ კონფიგურაციას თქვენს მანქანაზე:

```bash
omniroute setup-codex        omniroute setup-claude       omniroute setup-opencode
omniroute setup-cline        omniroute setup-kilo         omniroute setup-continue
omniroute setup-cursor       omniroute setup-roo          omniroute setup-crush
omniroute setup-goose        omniroute setup-qwen         omniroute setup-aider
omniroute setup-5dive
```

თითოეული იღებს `--remote <url> --api-key <key>` (ლოკალური ხელსაწყოს კონფიგურაცია დისტანციური OmniRoute-ს წინააღმდეგ), `--dry-run` (წინასწარი ნახვა ჩაწერის გარეშე) და `--port`. ხელსაწყოები მოდელის ავტომატური აღმოჩენის გარეშე (Cline, Kilo, Roo, Goose, Aider, Qwen, 5dive) იღებენ `--model <id>` (და `--yes` არაინტერაქტიული გაშვებისთვის). `setup-5dive` არის ერთადერთი რეცეპტი, რომელიც არ წერს `$HOME`-ის ქვეშ: ის აკონფიგურირებს 5dive აგენტების ფლოტს ფლოტის ჰოსტზე root-ის მფლობელობაში არსებული ავთენტიფიკაციის პროფილის ჩაწერით, ამიტომ ის ხელახლა სრულდება `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` რეცეპტი.

> **სრული ცნობარი:** ძირითადი ცხრილი — რას წერს თითოეული ბრძანება, ყოველი დროშა, ლოკალური vs დისტანციური, და რომელ ხელსაწყოებს სჭირდებათ `/v1` სუფიქსი — მოცემულია
> **[CLI ინტეგრაციები](../guides/CLI-INTEGRATIONS.md)**.

### ამათი გაშვება კონტეინერში

`setup-*` ბრძანება, რომელიც სრულდება OmniRoute კონტეინერში, წერს კონტეინერის საკუთარ home დირექტორიაში, რომელსაც არცერთი ჰოსტ CLI არ კითხულობს და რომელიც ქრება კონტეინერთან ერთად. OmniRoute ამას ამოიცნობს და გამოდის `2` კოდით ინსტრუქციებით, ნაცვლად ჩაწერისა. ორი მხარდაჭერილი გზაა — დააინსტალირეთ CLI ჰოსტზე და `omniroute connect` კონტეინერთან, ან დაამაუნტეთ კონფიგურაციის დირექტორიები და დააყენეთ `CLI_CONFIG_HOME` (compose `host` პროფილი). ყოველი `setup-*` ბრძანება, პლუს `omniroute configure` და `omniroute config set`, იღებს `--allow-container-write`-ს, როდესაც კონტეინერის საკუთარი CLI-ების კონფიგურაცია არის ის, რაც თქვენ ნამდვილად გქონდათ მხედველობაში; `OMNIROUTE_ALLOW_CONTAINER_CONFIG_WRITE=true` იგივეს აკეთებს სერვერისთვის. იხილეთ
[Docker Guide → ჰოსტ CLI ხელსაწყოების კონფიგურაცია](../guides/DOCKER_GUIDE.md#configuring-host-cli-tools-when-omniroute-runs-in-docker).

დაფის **apply endpoint** (`POST /api/cli-tools/apply`) აწესებს იგივე დაცვას: კონტეინერში, ჩაწერა, რომლის სამიზნე არ არის ჰოსტიდან bind-mounted, პასუხობს **`422`** `containerEphemeralTarget: true`-ით, უსაფრთხო შეცდომის ტექსტით და — ხელსაწყოებისთვის, რომლებსაც აქვთ ჰოსტის რეცეპტი (claude, codex, opencode, cline, kilo, continue) — `hostSetupCommand`-ით (მაგ. `omniroute setup-opencode`), რომელიც უნდა გაუშვათ ჰოსტზე; არაფერი იწერება. `dryRun: true` აგრძელებს მუშაობას კონტეინერის რეჟიმში და აბრუნებს რედაქტირებულ წინასწარ ნახვას + სამიზნე გზას დისკზე შეხების გარეშე. წინასწარი ნახვის შინაარსი არ არის სერთიფიკატის შემცველი კონფიგურაცია კოპირებისთვის ან იმპორტისთვის. გამოიყენეთ ორიგინალური ხელსაწყო/ძირითადი URL/API გასაღები/მოდელის შეყვანები ჰოსტზე, ან გამოიყენეთ მითითებული ჰოსტის მხარეს არსებული დაყენების ბრძანება. იხილეთ [CLI კონფიგურაციის უსაფრთხოება](../security/CLI-CONFIGURATION.md) წინასწარი ნახვის სათაურისა და მოთხოვნის კონტრაქტისთვის. ეს ქცევა განზრახულია და რეგრესიისგან დაცულია
`tests/unit/api/cli-tools/apply-container-guard.test.ts`-ით — არასოდეს „გამოასწოროთ“ 422 დაცვის მოხსნით.

---

## ჭეშმარიტების წყარო

ერთიანი კატალოგი განთავსებულია `src/shared/constants/cliTools.ts`-ში, როგორც `CLI_TOOLS: Record<string, CliCatalogEntry>`.

თითოეული ჩანაწერი შეიცავს შემდეგ ველებს (განსაზღვრულია `src/shared/schemas/cliCatalog.ts`-ში):

| ველი                                            | ტიპი                                                         | აღწერა                                                                                    |
| ----------------------------------------------- | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------- |
| `category`                                      | `"code" \| "agent"`                                          | რომელ გვერდზე გამოჩნდება ინსტრუმენტი                                                      |
| `vendor`                                        | `string`                                                     | ინსტრუმენტის წარმომავლობა ("Anthropic", "OSS (P. Gauthier)")                              |
| `acpSpawnable`                                  | `boolean`                                                    | შესაძლებელია ACP Agent-ის სახით გამოყენებაც (ნაჩვენებია ნიშანი)                           |
| `baseUrlSupport`                                | `"full" \| "partial" \| "none"`                              | მორგებული საბოლოო წერტილის მხარდაჭერის დონე. `"none"` = MITM-ის სამომავლო სამუშაოების სია |
| `configType`                                    | `"env" \| "custom" \| "guide" \| "custom-builder" \| "mitm"` | კონფიგურაციის მექანიზმი                                                                   |
| `id`, `name`, `color`, `description`, `docsUrl` | სტანდარტული                                                  | ძირითადი საჩვენებელი ველები                                                               |

ჩანაწერები, რომლებშიც მითითებულია `baseUrlSupport: "none"`, მართვის პანელის გვერდებზე **არ ჩანს** — ისინი რეგისტრირებულია MITM-ის სამომავლო სამუშაოების სიაში მე-11 გეგმისთვის (იხილეთ `_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>`-ის მიერ (განსაზღვრულია გარემოს/არგუმენტების ჩასმა)       | `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           | name                    | vendor                  | 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"` აქვთ, დაფის ბარათზე ნაჩვენებია სამკერდე ნიშანი „⚠ ნაწილობრივი საბაზისო 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`-იდან) ნაჩვენებია CLI-ები, რომელთა **გაშვებაც** OmniRoute-ს შეუძლია, როგორც ბექენდის შესრულების ძრავებისა, stdio/ACP პროტოკოლის მეშვეობით. კატალოგი ცალკე იმართება `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 მოლოდინის ლიმიტით
- კეში: მეხსიერებაში განთავსებული LRU, ინდექსირებული კონფიგურაციის ფაილის `mtime`-ის მიხედვით. კეში უქმდება, როდესაც mtime იცვლება. ნულდება სერვერის გადატვირთვისას.

თითოეული ხელსაწყოს პასუხის სტრუქტურა:

```ts
interface ToolBatchStatus {
  detection: {
    installed: boolean;
    runnable: boolean;
    version?: string;
    command?: string;
    commandPath?: string;
    reason?: string;
  };
  config: {
    status: "configured" | "not_configured" | "not_installed" | "unknown" | "other";
    endpoint?: string | null;
    lastConfiguredAt?: string | null;
  };
  error?: string; // გასუფთავებული, სტეკის ტრეისების გარეშე
}
```

---

## 6. პარამეტრების დამმუშავებლები ახალი ხელსაწყოებისთვის

ახალ ხელსაწყოებს, რომლებსაც აქვთ `configType: "custom"`, პარამეტრების API-ის გამოყოფილი მარშრუტები აქვთ:

| მარშრუტი                                    | ხელსაწყო                                                                        |
| ------------------------------------------- | ------------------------------------------------------------------------------- |
| `POST /api/cli-tools/forge-settings`        | ForgeCode (.forge.toml)                                                         |
| `POST /api/cli-tools/jcode-settings`        | jcode (--base-url ალამი)                                                        |
| `POST /api/cli-tools/deepseek-tui-settings` | DeepSeek TUI (OPENAI_BASE_URL, მოძველებული)                                     |
| `POST /api/cli-tools/codewhale-settings`    | CodeWhale (OPENAI_BASE_URL, ძირითადი + მოძველებული `~/.deepseek` სინქრონიზაცია) |
| `POST /api/cli-tools/smelt-settings`        | Smelt                                                                           |
| `POST /api/cli-tools/pi-settings`           | Pi პროგრამირების აგენტი                                                         |
| `POST /api/cli-tools/grok-build-settings`   | Grok Build (~/.grok/config.toml, `[model.omniroute]`)                           |
| `POST /api/cli-tools/qwen-settings`         | Qwen Code (`~/.qwen/settings.json` + გამოყოფილი `.env` გასაღები)                |

ყველა მარშრუტი შეცდომის პასუხებისთვის იყენებს `sanitizeErrorMessage()`-ს (მკაცრი წესი #12).

---

## 7. დაფის გვერდების არქიტექტურა

### CLI Code-ის (`/dashboard/cli-code`)

- `src/app/(dashboard)/dashboard/cli-code/page.tsx` — სერვერის კომპონენტი
- `src/app/(dashboard)/dashboard/cli-code/CliCodePageClient.tsx` — კლიენტის ბადე
- `src/app/(dashboard)/dashboard/cli-code/[id]/page.tsx` — ხელსაწყოს დეტალების გვერდი
- `src/app/(dashboard)/dashboard/cli-code/components/` — ხელსაწყოს 12 სპეციალიზებული ბარათი + `ToolDetailClient.tsx`

### CLI აგენტები (`/dashboard/cli-agents`)

- `src/app/(dashboard)/dashboard/cli-agents/page.tsx` — სერვერის კომპონენტი
- `src/app/(dashboard)/dashboard/cli-agents/CliAgentsPageClient.tsx` — კლიენტის ბადე
- `src/app/(dashboard)/dashboard/cli-agents/[id]/page.tsx` — ხელახლა იყენებს `ToolDetailClient`-ს

### ACP აგენტები (`/dashboard/acp-agents`)

- `src/app/(dashboard)/dashboard/acp-agents/page.tsx` — სერვერის კომპონენტი (გადატანილია `agents/`-იდან)

### საზიარო UI კომპონენტები (`src/shared/components/cli/`)

| ფაილი                   | დანიშნულება                                                             |
| ----------------------- | ----------------------------------------------------------------------- |
| `CliToolCard.tsx`       | მდგომარეობის ჭკვიანი ბარათი (აღმოჩენა + კონფიგურაცია + საბოლოო წერტილი) |
| `CliConceptCard.tsx`    | თითოეული გვერდისთვის კონცეფციის განმარტების ბარათი                      |
| `CliComparisonCard.tsx` | CLI ტიპების სამსვეტიანი შედარება                                        |
| `BaseUrlSelect.tsx`     | საბოლოო წერტილის ჩამოსაშლელი სია (ლოკალური/ღრუბლოვანი/მორგებული)        |
| `ApiKeySelect.tsx`      | API გასაღების ამრჩევი                                                   |
| `ManualConfigModal.tsx` | კოპირებადი კონფიგურაციის ფრაგმენტის მოდალური ფანჯარა                    |

### საზიარო ჰუკი (`src/shared/hooks/cli/`)

| ფაილი                     | დანიშნულება                                                                       |
| ------------------------- | --------------------------------------------------------------------------------- |
| `useToolBatchStatuses.ts` | იღებს `/api/cli-tools/all-statuses`-ს, მართავს ჩატვირთვის/განახლების მდგომარეობას |

---

## 8. i18n

მე-14 გეგმის F9-ში დაემატა ახალი სახელთა სივრცეები:

| სახელთა სივრცე | დანიშნულება                                                                                         |
| -------------- | --------------------------------------------------------------------------------------------------- |
| `cliCommon`    | საერთო სტრიქონები (ბარათების წარწერები, კონცეფციის/შედარების ტექსტები, დეტალების გვერდის წარწერები) |
| `cliCode`      | CLI Code-ის გვერდის სტრიქონები                                                                      |
| `cliAgents`    | CLI Agents-ის გვერდის სტრიქონები                                                                    |
| `acpAgents`    | ACP Agents-ის გვერდის სტრიქონები                                                                    |

მოწოდებულია სრული PT-BR და EN თარგმანები. დანარჩენი 39 ლოკალი ავტომატურად იყენებს EN-ს, `src/i18n/request.ts`-ში სახელთა სივრცის დონეზე გაერთიანების მეშვეობით.

---

## 9. სწრაფი დაწყება

### ნაბიჯი 1 — მიიღეთ OmniRoute API გასაღები

1. გახსენით `/dashboard/api-manager` → **API გასაღების შექმნა**
2. მიანიჭეთ სახელი (მაგ., `cli-tools`) და აირჩიეთ ყველა ნებართვა
3. დააკოპირეთ გასაღები — ის ქვემოთ ჩამოთვლილი ყველა CLI-სთვის დაგჭირდებათ

> თქვენი გასაღები ასე გამოიყურება: `sk-xxxxxxxxxxxxxxxx-xxxxxxxxx`

---

### ნაბიჯი 2 — დააინსტალირეთ CLI ინსტრუმენტები

npm-ზე დაფუძნებული ყველა ინსტრუმენტი საჭიროებს Node.js 22.22.2+ ან 24.x ვერსიას:

```bash
# Claude Code (Anthropic)
npm install -g @anthropic-ai/claude-code

# OpenAI Codex
npm install -g @openai/codex

# OpenCode
npm install -g opencode-ai

# Cline
npm install -g cline

# KiloCode
npm install -g kilocode

# Qwen Code
npm install -g @qwen-code/qwen-code

# Google Gemini CLI (`omniroute run gemini`-ის მეშვეობით გაშვებადი → /v1beta ინტერფეისი)
npm install -g @google/gemini-cli

# Aider
pip install aider-chat

# Smelt
cargo install smelt  # Rust-ზე დაფუძნებული

# Pi პროგრამირების აგენტი
# ინსტალაციისთვის იხილეთ https://github.com/zechnerj/pi-coding-agent

# jcode
# ინსტალაციისთვის იხილეთ https://github.com/1jehuang/jcode
```

---

### ნაბიჯი 3 — დააკონფიგურირეთ მართვის პანელის მეშვეობით

1. გადადით `http://localhost:20128/dashboard/cli-code` მისამართზე
2. ბადეში იპოვეთ თქვენი ინსტრუმენტი
3. ინსტრუმენტის დეტალების გვერდის გასახსნელად დააწკაპუნეთ ბარათზე
4. აირჩიეთ თქვენი API გასაღები და საბაზისო URL
5. დააწკაპუნეთ **კონფიგურაციის გამოყენებაზე** ან დააკოპირეთ ხელით კონფიგურაციის ფრაგმენტი

---

### ნაბიჯი 4 — დააყენეთ გლობალური გარემოს ცვლადები

```bash
# OmniRoute-ის უნივერსალური საბოლოო წერტილი
export OPENAI_BASE_URL="http://localhost:20128/v1"
export OPENAI_API_KEY="sk-your-omniroute-key"
export ANTHROPIC_BASE_URL="http://localhost:20128"
export ANTHROPIC_AUTH_TOKEN="sk-your-omniroute-key"
# Gemini CLI კითხულობს GOOGLE_GEMINI_BASE_URL-ს ROOT დონეზე (მისი SDK თავად ამატებს /v1beta/...-ს)
export GOOGLE_GEMINI_BASE_URL="http://localhost:20128"
export GEMINI_API_KEY="sk-your-omniroute-key"
```

> **დისტანციური სერვერისთვის** `localhost:20128` ჩაანაცვლეთ სერვერის IP მისამართით ან დომენით,
> მაგ., `http://<your-server-ip>:20128`.

---

### ნაბიჯი 4 — დააკონფიგურირეთ თითოეული ინსტრუმენტი

#### Claude Code

```bash
# შექმენით ~/.claude/settings.json:
mkdir -p ~/.claude && cat > ~/.claude/settings.json << EOF
{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:20128",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-omniroute-key"
  }
}
EOF
```

Claude Code-ისთვის გამოიყენეთ ერთიანი Anthropic კარიბჭის ძირეული მისამართი. აქ `/v1` არ დაამატოთ.

**ტესტი:** `claude "say hello"`

---

#### OpenAI Codex

თანამედროვე Codex (v0.137+) მხოლოდ `~/.codex/config.toml`-ს კითხულობს — ძველი
`config.yaml` მემკვიდრეობით npm CLI-ს ეკუთვნის და გაფრთხილების გარეშე იგნორირდება. API
გასაღები რჩება `OMNIROUTE_API_KEY` გარემოს ცვლადში (`env_key`) და არასდროს
ფაილის შიგნით:

```bash
mkdir -p ~/.codex && cat > ~/.codex/config.toml << EOF
model_provider = "omniroute"

[model_providers.omniroute]
name                 = "OmniRoute"
base_url             = "http://localhost:20128/v1"
env_key              = "OMNIROUTE_API_KEY"
requires_openai_auth = false
EOF
export OMNIROUTE_API_KEY="sk-your-omniroute-key"
```

სრული ცნობარი (პროფილები, `wire_api`, კონტექსტის ფანჯრები): [CODEX-CLI-CONFIGURATION.md](../guides/CODEX-CLI-CONFIGURATION.md).

**ტესტი:** `codex "what is 2+2?"`

---

#### OpenCode

```bash
mkdir -p ~/.config/opencode && cat > ~/.config/opencode/opencode.json << EOF
{
  "\$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniRoute",
      "options": {
        "baseURL": "http://localhost:20128/v1",
        "apiKey": "sk-your-omniroute-key"
      },
      "models": {
        "claude-sonnet-4-5": { "name": "claude-sonnet-4-5" },
        "claude-sonnet-4-5-thinking": { "name": "claude-sonnet-4-5-thinking" },
        "gemini-3-flash": { "name": "gemini-3-flash" }
      }
    }
  }
}
EOF
```

**ტესტი:** `opencode`

> სააზროვნო ვარიანტების გასაგზავნად გამოიყენეთ `opencode run "your prompt" --model omniroute/claude-sonnet-4-5-thinking --variant high`.

---

#### Cline (CLI ან VS Code)

**CLI რეჟიმი:**

```bash
mkdir -p ~/.cline/data && cat > ~/.cline/data/globalState.json << EOF
{
  "apiProvider": "openai",
  "openAiBaseUrl": "http://localhost:20128/v1",
  "openAiApiKey": "sk-your-omniroute-key"
}
EOF
```

**VS Code რეჟიმი:**
Cline გაფართოების პარამეტრები → API პროვაიდერი: `OpenAI Compatible` → საბაზისო URL: `http://localhost:20128/v1`

ან გამოიყენეთ OmniRoute-ის მართვის პანელი → **CLI ინსტრუმენტები → Cline → კონფიგურაციის გამოყენება**.

---

#### KiloCode (CLI ან VS Code)

**CLI რეჟიმი:**

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

**VS Code-ის პარამეტრები:**

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

ან გამოიყენეთ OmniRoute-ის მართვის პანელი → **CLI ინსტრუმენტები → KiloCode → კონფიგურაციის გამოყენება**.

---

#### Continue (VS Code გაფართოება)

დაარედაქტირეთ `~/.continue/config.yaml`:

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

რედაქტირების შემდეგ გადატვირთეთ VS Code.

---

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

გამოიყენეთ ეს მაშინ, როდესაც VS Code Insiders კონფიგურირებულია მორგებული საბოლოო წერტილის მოდელებისთვის და გსურთ, რომ OmniRoute-მა მორგებული სათაურის ველის გარეშე იმუშაოს.

**რეკომენდებული მდებარეობა:**

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

**OmniRoute-ის ტოკენიზებული ფსევდონიმის გამოყენების მაგალითი:**

```json
[
  {
    "vendor": "customendpoint",
    "id": "auto",
    "name": "OmniRoute Auto",
    "family": "gpt-4",
    "version": "1.0.0",
    "url": "http://localhost:20128/api/v1/vscode/sk-your-omniroute-key/chat/completions",
    "modelsUrl": "http://localhost:20128/api/v1/vscode/sk-your-omniroute-key/models",
    "requestFormat": "openai-chat-completions",
    "contextWindow": 256000,
    "maxOutputTokens": 32768,
    "auth": {
      "type": "none"
    }
  }
]
```

**შენიშვნები:**

- ჩაანაცვლეთ `sk-your-omniroute-key` OmniRoute-ში შექმნილი API გასაღებით.
- `url` ველი უნდა მიუთითებდეს `/api/v1/vscode/{token}/chat/completions`-ზე.
- `modelsUrl` ველი უნდა მიუთითებდეს `/api/v1/vscode/{token}/models`-ზე.
- როდესაც კლიენტს მორგებული სათაურების მხარდაჭერა აქვს, უპირატესობა მიანიჭეთ სტანდარტულ `/v1` + Bearer სათაურის სქემას.
- URL-ში ჩაშენებული ტოკენები თავსებადობის სარეზერვო ვარიანტია და შესაძლოა რედაქტორის ჟურნალებში ან პროქსის ისტორიაში გამოჩნდეს.

---

#### Kiro CLI (Amazon)

```bash
# შედით თქვენს AWS/Kiro ანგარიშში:
kiro-cli login

# CLI საკუთარ ავთენტიფიკაციას იყენებს — თავად Kiro CLI-სთვის OmniRoute ბექენდად საჭირო არ არის.
# სხვა ხელსაწყოებისთვის გამოიყენეთ kiro-cli OmniRoute-თან ერთად.
kiro-cli status
```

**Kiro IDE** დესკტოპ-აპისთვის გამოიყენეთ OmniRoute-ის მიერ ხელმისაწვდომი MITM საბოლოო წერტილი
`/dashboard/cli-tools → Kiro`-ის ქვეშ.

---

## 10. შიდა OmniRoute CLI

`omniroute` ბინარული ფაილი უზრუნველყოფს ბრძანებებს სერვერის სასიცოცხლო ციკლის, გამართვის, დიაგნოსტიკისა და პროვაიდერების მართვისთვის. შესვლის წერტილი: `bin/omniroute.mjs`.

```bash
omniroute                              # სერვერის გაშვება (ნაგულისხმევი პორტი 20128)
omniroute setup                        # ინტერაქტიული გამართვის ოსტატი
omniroute doctor                       # კონფიგურაციის, DB-ის, პორტებისა და გაშვების გარემოს შემოწმება
omniroute providers list               # კონფიგურირებული პროვაიდერების კავშირები
omniroute providers test-all           # ყველა აქტიური კავშირის შემოწმება
omniroute reset-password               # ადმინისტრატორის პაროლის ჩამოყრა
omniroute logs                         # მოთხოვნების ჟურნალების ნაკადის ჩვენება
omniroute health                       # ჯანმრთელობის დეტალური მდგომარეობა (ამომრთველები, კეში, მეხსიერება)
omniroute --version                    # ვერსიის გამოტანა
omniroute --help                       # ყველა ბრძანების ჩვენება
```

### გამართვა და ინიციალიზაცია

```bash
omniroute setup                        # ინტერაქტიული გამართვის ოსტატი
omniroute setup --non-interactive      # CI/ავტომატიზაციის რეჟიმი (კითხულობს გარემოს ცვლადებსა და ალმებს)
omniroute setup --password '<value>'   # ადმინისტრატორის პაროლის პირდაპირ დაყენება
omniroute setup --add-provider \
  --provider openai \
  --api-key '<value>' \
  --test-provider                      # პროვაიდერის დამატება და შემოწმება ერთი მოქმედებით
```

არაინტერაქტიული გამართვისთვის ამოცნობილი გარემოს ცვლადები:

| ცვლადი              | დანიშნულება                                                                                  |
| ------------------- | -------------------------------------------------------------------------------------------- |
| `OMNIROUTE_API_KEY` | პროვაიდერის API გასაღები (დაკავშირებულია `--api-key`-თან Commander-ის `.env()`-ის მეშვეობით) |
| `DATA_DIR`          | OmniRoute-ის მონაცემთა დირექტორიის ჩანაცვლება                                                |

ყველა სხვა არაინტერაქტიული შეყვანა გადაიცემა ალმების და არა გარემოს ცვლადების სახით:
`--password`, `--provider`, `--provider-name`, `--provider-base-url`, `--default-model`
(იხილეთ `omniroute setup`-ის პარამეტრები ზემოთ).

### დიაგნოსტიკა

```bash
omniroute doctor                       # კონფიგურაციის, DB-ის, პორტების, გაშვების გარემოს, მეხსიერებისა და სიცოცხლისუნარიანობის შემოწმება
omniroute doctor --json                # მანქანისთვის წაკითხვადი JSON
omniroute doctor --no-liveness         # HTTP ჯანმრთელობის შემოწმების გამოტოვება
omniroute doctor --host 0.0.0.0        # სიცოცხლისუნარიანობის ჰოსტის ჩანაცვლება
omniroute doctor --liveness-url <url>  # ჯანმრთელობის საბოლოო წერტილის სრული URL-ის ჩანაცვლება
```

doctor ასრულებს შემდეგ შემოწმებებს: `Config`, `Database`, `Storage/encryption`,
`Port availability`, `Node runtime`, `Native binary` (better-sqlite3),
`Memory` და `Server liveness`. თუ რომელიმე შემოწმების შედეგია `fail`, ის მუშაობას არანულოვანი კოდით ასრულებს.

### პროვაიდერების მართვა

```bash
omniroute providers available                       # OmniRoute-ის პროვაიდერების კატალოგი
omniroute providers available --search openai       # კატალოგის გაფილტვრა id-ის/სახელის/ფსევდონიმის/კატეგორიის მიხედვით
omniroute providers available --category api-key    # კატეგორიის მიხედვით გაფილტვრა (api-key, oauth, free, ...)
omniroute providers available --json                # მანქანისთვის წაკითხვადი JSON

omniroute providers list                            # კონფიგურირებული პროვაიდერების კავშირები
omniroute providers list --json

omniroute providers test <id|name>                  # ერთი კონფიგურირებული კავშირის შემოწმება
omniroute providers test-all                        # ყველა აქტიური კავშირის შემოწმება
omniroute providers validate                        # მხოლოდ ლოკალური სტრუქტურული ვალიდაცია
omniroute providers add <provider> --credential-env PROVIDER_KEY
omniroute providers import ./providers.json --dry-run --json
omniroute providers auth <provider>                 # არსებული OAuth ნაკადი
omniroute providers edit <id|name> --default-model <model>
omniroute providers remove <id|name> --yes
```

`providers add/import/auth/edit/remove` უპირველესად API-ზეა დაფუძნებული და ამიტომ მუშაობს
აქტიური ლოკალური ან დისტანციური კონტექსტის მიმართ. ავტორიზაციის მონაცემების შეყვანისთვის უნდა გამოიყენოთ
`--credential-stdin` ან `--credential-env`; `--dry-run --json` მხოლოდ
დაფარულ არსებობას/ფორმას აჩვენებს. `providers available` კითხულობს OmniRoute-ის კატალოგს;
`providers list/test/test-all/validate` ინარჩუნებს ლოკალურ SQLite ქცევას და
არ საჭიროებს სერვერის გაშვებულ მდგომარეობას.

### აღდგენა და ჩამოყრა

```bash
omniroute reset-password                # ადმინისტრატორის პაროლის ჩამოყრა (ასევე: omniroute-reset-password)
omniroute reset-encrypted-columns       # დაშიფრული ავტორიზაციის მონაცემების ჩამოყრისთვის გაფრთხილებისა და საცდელი გაშვების ჩვენება
omniroute reset-encrypted-columns --force  # SQLite-ში დაშიფრული ავტორიზაციის მონაცემების რეალურად null-ად ქცევა
```

### ავტორიზაციის მონაცემების ექსპორტი (⚠ სიფრთხილით მოეპყარით)

```bash
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 სერვერს:

```bash
omniroute status                       # შესრულების გარემოს სრული სტატუსი
omniroute logs                         # მოთხოვნების ჟურნალის ნაკადის ჩვენება (--json, --search, --follow)
omniroute config list                  # კონფიგურირებული CLI ხელსაწყოების ჩვენება

omniroute provider list                # ხელმისაწვდომი პროვაიდერების ჩამონათვალი (providers list-ის ფსევდონიმი)
omniroute provider add                 # OmniRoute-ის პროვაიდერად რეგისტრაცია ხელსაწყოში
omniroute keys add | list | remove     # API გასაღებების მართვა
omniroute models [provider]            # მოდელების ჩამონათვალი (--json, --search)
omniroute combo list | switch | create | delete

omniroute backup                       # კონფიგურაციისა და DB-ის სარეზერვო ასლის შექმნა
omniroute restore                      # წინა სარეზერვო ასლიდან აღდგენა

omniroute health                       # მდგომარეობის დეტალები (ამომრთველები, კეში, მეხსიერება)
omniroute quota                        # პროვაიდერის კვოტის გამოყენება
omniroute cache                        # კეშის სტატუსი
omniroute cache clear                  # სემანტიკური და სიგნატურების კეშების გასუფთავება

omniroute mcp status | restart         # MCP სერვერის სტატუსი / გადატვირთვა
omniroute a2a status | card            # A2A სერვერის სტატუსი / აგენტის ბარათი

omniroute tunnel list | create | stop  # გვირაბების მართვა (cloudflare/tailscale/ngrok)
omniroute env show | get <k> | set <k> <v>  # გარემოს ცვლადების ნახვა / დაყენება (დროებით)

omniroute test                         # პროვაიდერთან კავშირის სწრაფი ტესტი
omniroute update                       # განახლებების შემოწმება
omniroute completion                   # გარსისთვის ავტოდასრულების გენერირება
```

### გავრცელებული ალმები

| ალამი               | აღწერა                                                            |
| ------------------- | ----------------------------------------------------------------- |
| `--no-open`         | გაშვებისას ბრაუზერი ავტომატურად არ გაიხსნას                       |
| `--port <n>`        | API პორტის ჩანაცვლება (ნაგულისხმევია 20128)                       |
| `--mcp`             | MCP სერვერად გაშვება stdio-ს მეშვეობით (IDE-ებისთვის)             |
| `--non-interactive` | CI რეჟიმი (მინიშნებების გარეშე; კითხულობს env/flags-დან)          |
| `--json`            | მანქანურად წაკითხვადი JSON გამომავალი (doctor, providers და ა.შ.) |
| `--help`, `-h`      | კონკრეტული ბრძანების დახმარების ჩვენება                           |
| `--version`, `-v`   | დაყენებული ვერსიის გამოტანა                                       |

---

## ხელმისაწვდომი API ენდპოინტები

| ენდპოინტი                  | აღწერა                              | გამოყენების დანიშნულება                          |
| -------------------------- | ----------------------------------- | ------------------------------------------------ |
| `/v1/chat/completions`     | სტანდარტული ჩატი (ყველა პროვაიდერი) | ყველა თანამედროვე ხელსაწყო                       |
| `/v1/responses`            | Responses API (OpenAI-ის ფორმატი)   | Codex, აგენტური სამუშაო პროცესები                |
| `/v1/completions`          | ტექსტის შევსების მოძველებული API    | ძველი ხელსაწყოები, რომლებიც იყენებენ `prompt:`-ს |
| `/v1/embeddings`           | ტექსტის ემბედინგები                 | RAG, ძიება                                       |
| `/v1/images/generations`   | სურათების გენერაცია                 | GPT-Image, Flux და სხვ.                          |
| `/v1/audio/speech`         | ტექსტის მეტყველებად გარდაქმნა       | ElevenLabs, OpenAI TTS                           |
| `/v1/audio/transcriptions` | მეტყველების ტექსტად გარდაქმნა       | Deepgram, AssemblyAI                             |

ჩასასმელად გამზადებული მაგალითები ტოკენიზებული OmniRoute URL-ით:

```txt
ტოკენის მაგალითი: sk-a3ab3c080beaee3a-69f4a4-070d71af

სტანდარტული OpenAI-ის საბაზისო მისამართი: http://localhost:20128/v1
VS Code-ის მოდელები: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/models
VS Code-ის ჩატი: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/chat/completions
VS Code-ის პასუხები: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/responses
Ollama-ს ტეგები: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/api/tags
Ollama-ს ჩატი: http://localhost:20128/api/v1/vscode/sk-a3ab3c080beaee3a-69f4a4-070d71af/api/chat
```

---

## პრობლემების აღმოფხვრა

| შეცდომა                                         | მიზეზი                                    | გამოსწორება                                                   |
| ----------------------------------------------- | ----------------------------------------- | ------------------------------------------------------------- |
| `Connection refused`                            | OmniRoute გაშვებული არ არის               | `omniroute serve`                                             |
| `401 Unauthorized`                              | არასწორი API გასაღები                     | შეამოწმეთ `/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) |