# Remote Mode (Gaeilge) 🌐 **Languages:** 🇺🇸 [English](../../../../guides/REMOTE-MODE.md) · 🇪🇹 [am](../../../am/docs/guides/REMOTE-MODE.md) · 🇸🇦 [ar](../../../ar/docs/guides/REMOTE-MODE.md) · 🇦🇿 [az](../../../az/docs/guides/REMOTE-MODE.md) · 🇧🇬 [bg](../../../bg/docs/guides/REMOTE-MODE.md) · 🇧🇩 [bn](../../../bn/docs/guides/REMOTE-MODE.md) · 🇧🇦 [bs](../../../bs/docs/guides/REMOTE-MODE.md) · 🇨🇿 [cs](../../../cs/docs/guides/REMOTE-MODE.md) · 🇩🇰 [da](../../../da/docs/guides/REMOTE-MODE.md) · 🇩🇪 [de](../../../de/docs/guides/REMOTE-MODE.md) · 🇬🇷 [el](../../../el/docs/guides/REMOTE-MODE.md) · 🇪🇸 [es](../../../es/docs/guides/REMOTE-MODE.md) · 🇪🇪 [et](../../../et/docs/guides/REMOTE-MODE.md) · 🇮🇷 [fa](../../../fa/docs/guides/REMOTE-MODE.md) · 🇫🇮 [fi](../../../fi/docs/guides/REMOTE-MODE.md) · 🇫🇷 [fr](../../../fr/docs/guides/REMOTE-MODE.md) · 🇮🇳 [gu](../../../gu/docs/guides/REMOTE-MODE.md) · 🇳🇬 [ha](../../../ha/docs/guides/REMOTE-MODE.md) · 🇮🇱 [he](../../../he/docs/guides/REMOTE-MODE.md) · 🇮🇳 [hi](../../../hi/docs/guides/REMOTE-MODE.md) · 🇭🇷 [hr](../../../hr/docs/guides/REMOTE-MODE.md) · 🇭🇺 [hu](../../../hu/docs/guides/REMOTE-MODE.md) · 🇦🇲 [hy](../../../hy/docs/guides/REMOTE-MODE.md) · 🇮🇩 [id](../../../id/docs/guides/REMOTE-MODE.md) · 🇳🇬 [ig](../../../ig/docs/guides/REMOTE-MODE.md) · 🇮🇹 [it](../../../it/docs/guides/REMOTE-MODE.md) · 🇯🇵 [ja](../../../ja/docs/guides/REMOTE-MODE.md) · 🇬🇪 [ka](../../../ka/docs/guides/REMOTE-MODE.md) · 🇰🇭 [km](../../../km/docs/guides/REMOTE-MODE.md) · 🇮🇳 [kn](../../../kn/docs/guides/REMOTE-MODE.md) · 🇰🇷 [ko](../../../ko/docs/guides/REMOTE-MODE.md) · 🇱🇹 [lt](../../../lt/docs/guides/REMOTE-MODE.md) · 🇱🇻 [lv](../../../lv/docs/guides/REMOTE-MODE.md) · 🇮🇳 [ml](../../../ml/docs/guides/REMOTE-MODE.md) · 🇮🇳 [mr](../../../mr/docs/guides/REMOTE-MODE.md) · 🇲🇾 [ms](../../../ms/docs/guides/REMOTE-MODE.md) · 🇲🇹 [mt](../../../mt/docs/guides/REMOTE-MODE.md) · 🇲🇲 [my](../../../my/docs/guides/REMOTE-MODE.md) · 🇳🇵 [ne](../../../ne/docs/guides/REMOTE-MODE.md) · 🇳🇱 [nl](../../../nl/docs/guides/REMOTE-MODE.md) · 🇳🇴 [no](../../../no/docs/guides/REMOTE-MODE.md) · 🇮🇳 [or](../../../or/docs/guides/REMOTE-MODE.md) · 🇮🇳 [pa](../../../pa/docs/guides/REMOTE-MODE.md) · 🇵🇭 [phi](../../../phi/docs/guides/REMOTE-MODE.md) · 🇵🇱 [pl](../../../pl/docs/guides/REMOTE-MODE.md) · 🇵🇹 [pt](../../../pt/docs/guides/REMOTE-MODE.md) · 🇧🇷 [pt-BR](../../../pt-BR/docs/guides/REMOTE-MODE.md) · 🇷🇴 [ro](../../../ro/docs/guides/REMOTE-MODE.md) · 🇷🇺 [ru](../../../ru/docs/guides/REMOTE-MODE.md) · 🇱🇰 [si](../../../si/docs/guides/REMOTE-MODE.md) · 🇸🇰 [sk](../../../sk/docs/guides/REMOTE-MODE.md) · 🇸🇮 [sl](../../../sl/docs/guides/REMOTE-MODE.md) · 🇷🇸 [sr](../../../sr/docs/guides/REMOTE-MODE.md) · 🇸🇪 [sv](../../../sv/docs/guides/REMOTE-MODE.md) · 🇰🇪 [sw](../../../sw/docs/guides/REMOTE-MODE.md) · 🇮🇳 [ta](../../../ta/docs/guides/REMOTE-MODE.md) · 🇮🇳 [te](../../../te/docs/guides/REMOTE-MODE.md) · 🇹🇭 [th](../../../th/docs/guides/REMOTE-MODE.md) · 🇹🇷 [tr](../../../tr/docs/guides/REMOTE-MODE.md) · 🇺🇦 [uk-UA](../../../uk-UA/docs/guides/REMOTE-MODE.md) · 🇵🇰 [ur](../../../ur/docs/guides/REMOTE-MODE.md) · 🇺🇿 [uz](../../../uz/docs/guides/REMOTE-MODE.md) · 🇻🇳 [vi](../../../vi/docs/guides/REMOTE-MODE.md) · 🇳🇬 [yo](../../../yo/docs/guides/REMOTE-MODE.md) · 🇨🇳 [zh-CN](../../../zh-CN/docs/guides/REMOTE-MODE.md) · 🇹🇼 [zh-TW](../../../zh-TW/docs/guides/REMOTE-MODE.md) --- Rith an CLI `omniroute` ar do ríomhaire glúine agus OmniRoute féin ag rith áit éigin eile (VPS, freastalaí baile, ríomhaire eile ar do Tailnet). Logálann tú isteach uair amháin le `omniroute connect`, agus as sin amach díríonn **gach** ordú CLI ar an gcianfhreastalaí sin — na horduithe céanna, an t-aschur céanna, ach iad curtha i gcrích ar an gcianfhreastalaí. Níl aon dara uirlis le suiteáil: is éard atá sa mhód cianda ná an gnáth-CLI `omniroute` mar aon le **comharthaí rochtana** a bhfuil raon feidhme acu. ```bash npm install -g omniroute # an gnáth-CLI omniroute connect 192.168.0.15 # logáil isteach (pasfhocal → comhartha le raon feidhme) omniroute models list # ← liostaítear anois samhlacha an CHIANFHREASTALAÍ omniroute configure codex # ← scríobhtar próifíl áitiúil Codex ón gcatalóg chianda ``` --- ## Conas a oibríonn sé ``` do ríomhaire glúine OmniRoute cianda (VPS) ┌────────────────────┐ ┌───────────────────────────────┐ │ CLI omniroute │ POST /api/cli/connect (pasfhocal → comhartha) │ │ comhthéacs: vps │ ───────────────► │ eisítear comhartha rochtana │ │ baseUrl, comhartha│ Authorization: Bearer oma_live_… │ │ │ ───────────────► │ gach bealach bainistíochta, │ │ scríobhann sé │ ◄─────────────── │ seiceáilte de réir raon feidhme│ │ cumraíochtaí GO │ │ an chomhartha │ │ HÁITIÚIL │ └───────────────────────────────┘ └────────────────────┘ ``` - Stórálann **comhthéacsanna** freastalaí amháin an ceann (`~/.omniroute/config.json`, `chmod 600`). Athraíonn `omniroute contexts use ` an freastalaí gníomhach; tá `default` áitiúil. - Údaraíonn **comharthaí rochtana** (`oma_live_…`) orduithe bainistíochta. Tá siad éagsúil le heochracha API tátail (`sk-…`, a úsáidtear le haghaidh `/v1/chat/completions`). - Ní stóráiltear ar thaobh an fhreastalaí ach hais SHA-256 de chomhartha. Taispeántar an gnáth-théacs **uair amháin**, tráth a chruthaithe. --- ## Ag nascadh ### Leis an bpasfhocal bainistíochta (tosú) ```bash omniroute connect 192.168.0.15 # Pasfhocal bainistíochta do http://192.168.0.15:20128: ******** # ✔ Ceangailte le http://192.168.0.15:20128 — comhthéacs '192.168.0.15' (raon feidhme: admin) ``` Eisíonn sreabhadh an phasfhocail comhartha **admin** de réir réamhshocraithe (tá an pasfhocal agat, mar sin tá smacht iomlán agat cheana féin). Laghdaigh an raon feidhme le `--scope`: ```bash omniroute connect 192.168.0.15 --scope write ``` Roghanna: `--port

` (nuair nach bhfuil port ag an óstach), `--name ` (ainm an chomhthéacs), `--scope read|write|admin`. Cloítear le URL iomlán díreach mar atá: `omniroute connect https://omni.example.com`. ### Le comhartha réamhghinte Gin comhartha a bhfuil raon feidhme aige sa deais (nó le `omniroute tokens create`) agus greamaigh é — níl pasfhocal ag teastáil: ```bash omniroute connect 192.168.0.15 --key oma_live_xxxxxxxx ``` Bailíochtaíonn an CLI é trí `GET /api/cli/whoami` agus sábhálann sé mar an comhthéacs gníomhach é. --- ## Raonta feidhme Trí leibhéal, in ordlathas (`admin ⊃ write ⊃ read`): | Raon feidhme | Cad is féidir a dhéanamh | | ------------ | ------------------------------------------------------------------------------------------------ | | `read` | liostú/iniúchadh — `models list`, `providers status`, `logs`, `usage`, `cost` | | `write` | léamh **+** cumrú/cur i bhfeidhm — `setup-codex`, `keys add`, `config set`, teaglamaí | | `admin` | scríobh **+** bainistiú — CRUD `tokens`, soláthraithe, seirbhísí, polasaí agus oauth a chur leis | Tátalaíonn an freastalaí an raon feidhme a theastaíonn ó gach bealach ón modh HTTP (`GET`→read, athruithe→write), chomh maith le liosta ceadaithe admin le haghaidh dromchlaí íogaire (athruithe ar `/api/cli/tokens` agus `/api/providers`, `/api/oauth`, `/api/services`, …). Faigheann comhartha nach bhfuil raon feidhme leordhóthanach aige `403` mar aon le teachtaireacht shoiléir. > Fanann bealaí a sheolann próisis (`/api/services/*`, `/api/mcp/*`, …) > **teoranta don lúb siar amháin** — ní féidir le comhartha cianda iad a rochtain choíche, beag beann ar a raon feidhme. --- ## Antigravity a nascadh ar shuiteáil chianda Úsáideann Antigravity scáileán toilithe firstparty/nativeapp Google. Ní eisíonn Google an cód údaraithe ach amháin nuair atá an **atreorú lúb-ais** (`http://127.0.0.1:/callback`) **insroichte ón mbrabhsálaí a cheadaíonn an síniú isteach**. Ar shuiteáil chianda VPS, tá an lúb-ais sin ar an bhfreastalaí, ní ar do ríomhaire, mar sin **crochann an scáileán toilithe go deo agus ní eisíonn sé cód riamh** — níl aon rud le greamú ag an ngnáthrogha chúltaca "greamaigh URL an aisghlaoigh". (Is srian de chuid Google é seo: tarlaíonn an chrochadh céanna in aon seachfhreastalaí a úsáideann an cliant deisce Antigravity atá cuachta leis, ní in OmniRoute amháin.) Aimsíonn an deais é seo sula dtéann tú i bhfostú: nuair a osclaítear **Soláthraithe → Antigravity → Ceangail** ó sheoladh nach localhost é, cuirtear an dá réiteach thíos in ionad an fhógra chineálaigh "cóipeáil URL an aisghlaoigh", agus d'óstach agus do phort líonta isteach cheana féin i ngach ceann acu. (Áirítear seoladh LAN — ní localhost é `192.168.x.x` a mhéid a bhaineann leis an aisghlaoch seo.) Tá dhá bhealach tacaithe ann chun Antigravity a nascadh le OmniRoute cianda. ### Rogha A — cúntóir logála isteach áitiúil (molta) Rith OAuth ar **do ríomhaire féin**, áit a bhfuil `127.0.0.1` insroichte. Labhraíonn an cúntóir go díreach le Google, mar sin cuirtear an toiliú i gcrích san áit nach féidir le leagan na deaise é a dhéanamh. **Má tá tú nasctha cheana féin** (`omniroute connect `), níl aon rud le cóipeáil — seachadann an cúntóir an dintiúr chuig an tsuiteáil sin duit: ```bash # Ar do ríomhaire ÁITIÚIL (teastaíonn Node.js + brabhsálaí): omniroute connect 192.168.0.15 # uair amháin — cruthaíonn sé comhartha comhthéacs le raon feidhme riarthóra npx omniroute login antigravity # ↳ osclaíonn sé toiliú Google, gabhann sé an t-aisghlaoch ar phort lúb-ais áitiúil, # malartaíonn sé é, agus POSTálann sé an dintiúr chuig an gcomhthéacs gníomhach: # # Antigravity nasctha ar http://192.168.0.15:20128 (nasc abc123). # Níl aon rud le greamú — is féidir leat an teirminéal seo a dhúnadh. ``` Tarlaíonn an brú go huathoibríoch aon uair a dhíríonn an comhthéacs gníomhach ar ríomhaire eile. Cuir i bhfeidhm é ar cheachtar bealach le `--push` / `--no-push`, nó dírigh ar chomhthéacs sonrach le `--context `. **Mura féidir le do ríomhaire an VPS a bhaint amach** (balla dóiteáin, gan SSH, deasc aer-bhearnaithe), oibríonn an cúntóir fós — ní _theastaíonn_ uaidh ach Google. Úsáid `--no-push`, nó lig don bhrú teip: mar rogha chúltaca, priontálann sé an blob seachas údarú atá curtha i gcrích agat cheana féin a chaitheamh i leataobh. ```bash npx omniroute login antigravity --no-push # omniroute-cred-v1.eyJ2IjoxLCJ... ``` Ansin, sa deais **chianda**: **Soláthraithe → Antigravity → Ceangail**, agus greamaigh an blob `omniroute-cred-v1.…` isteach sa réimse **Céim 2** (glacann sé le URL aisghlaoigh nó le blob dintiúir). Díchódaíonn OmniRoute é, ritheann sé ionduchtú Cloud Code ar thaobh an fhreastalaí, agus coinníonn sé an nasc. > Tá comhartha athnuachana sa bhlob — caith leis mar fhocal faire. Ar chonair an bhrú, > seoltar uair amháin é thar nasc fíordheimhnithe do chomhthéacs; ar chonair an > ghreamaithe, thar nasc do dheaise. Cibé bealach, stóráiltear criptithe é ar fos, agus > ní phriontálann brú rathúil chuig do theirminéal é riamh. Bratacha: `--no-browser` (priontáil an URL seachas é a oscailt go huathoibríoch), `--port ` (socraigh an port lúb-ais), `--timeout `, `--push` / `--no-push` (sáraigh an seachadadh uathoibríoch), `--context ` (dírigh ar chomhthéacs sonrach). ### Rogha B — tollán curtha ar aghaidh go háitiúil trí SSH Má tá rochtain SSH agat ar an VPS, cuir port na deaise ar aghaidh ionas go réiteoidh an t-aisghlaoch lúb-ais ar ais chuig an bhfreastalaí tríd an tollán: ```bash # Ar do ríomhaire ÁITIÚIL: ssh -L 20128:127.0.0.1:20128 user@your-vps # ansin oscail http://localhost:20128 i do bhrabhsálaí ÁITIÚIL agus nasc Antigravity # mar is gnách — sroicheann an t-atreorú 127.0.0.1:20128/callback an VPS anois trí SSH. ``` Toisc go sroicheann tú an deais mar `localhost:20128`, cuirtear toiliú Google i gcrích agus seachadtar an t-aisghlaoch chuig an bhfreastalaí tríd an tollán céanna — ní theastaíonn blob. Coinnigh an tollán ar oscailt go dtí go léirítear an nasc mar ghníomhach. Murab ionann agus na soláthraithe lúb-ais sheasta thíos, **is leor cur ar aghaidh amháin** anseo: úsáideann aisghlaoch Antigravity port na deaise féin, mar sin níl aon dara port a bhaineann go sonrach leis an soláthraí le cur trí thollán. > Rogha eile atá go hiomlán gan chomhéadan (gan chúntóir, gan tollán) is ea do > dhintiúir ghréasáin Google OAuth **féin** + URL bonn poiblí a chumrú; féach ar > athróga timpeallachta OAuth an tsoláthraí. Ní theastaíonn aon socrú breise Google > ón dá rogha thuas. --- ## Codex / Grok a nascadh ar shuiteáil chianda (soláthraithe aisfhillte fhosaithe) Cláraíonn Codex, xAI (`xai-oauth`) agus Grok CLI (`grok-cli`) `redirect_uri` aisfhillte **fosaithe** lena bhfeidhmchlár OAuth réamhtheachtach. Ní féidir le OmniRoute é a athrú — seolann an soláthraí an brabhsálaí ar ais chuig an seoladh céanna atá códaithe go crua i gcónaí: | Soláthraí | Aisghlao fosaithe a ndéanann an soláthraí atreorú chuige | | ----------- | -------------------------------------------------------- | | `codex` | `http://localhost:1455/auth/callback` | | `xai-oauth` | `http://127.0.0.1:56121/callback` | | `grok-cli` | `http://127.0.0.1:56122/callback` | Ciallaíonn `localhost` ansin **an ríomhaire ar a bhfuil an brabhsálaí ag rith**, agus éisteann freastalaí aisghlao PKCE OmniRoute ar aisfhilleadh an **fhreastalaí**. Oscail an painéal ag seoladh LAN amhail `http://192.168.0.15:20128` agus ní thagann an dá cheann le chéile choíche: seachadtar an cód údaraithe chuig `localhost:1455` do ríomhaire glúine féin, áit nach bhfuil aon rud ag éisteacht, agus teipeann ar an soláthraí an síniú isteach gan earráid a thaispeáint. Aimsíonn an painéal é seo sula n-osclaítear an phreabfhuinneog agus taispeánann sé an t-ordú tolláin in ionad ligean don logáil isteach teip go ciúin (#8046). ### Réiteach — cuir **an dá** phort ar aghaidh ```bash # Ar an ríomhaire ar a bhfuil an BRABHSÁLAÍ ag rith: ssh -L 20128:127.0.0.1:20128 -L 1455:127.0.0.1:1455 @192.168.0.15 # ansin téigh chuig http://localhost:20128 agus nasc Codex as sin ``` Tá dhá chur ar aghaidh riachtanach, agus teipeann fós mura gcuirtear ach ceann amháin ar aghaidh: - Fágann **`20128`** (port an phainéil) gur fíor-óstach logánta é an tionscnamh, rud a chuireann ar OmniRoute freastalaí aisghlao PKCE a thosú ar chor ar bith — ní shroicheann tionscnamh LAN an brainse sin choíche. - Is é **`1455`** (port aisghlao fosaithe an tsoláthraí) an áit a seoltar an brabhsálaí ar ais chuici; ní mór dó dul tríd an tollán chuig aisfhilleadh an fhreastalaí. Cuir `56121`/`56122` in ionad `1455` agus xAI nó Grok CLI á nascadh agat, agus cuir port iarbhír do phainéil in ionad `20128`. Coinnigh an tollán oscailte go dtí go dtaispeántar go bhfuil an nasc gníomhach. > **Gan rochtain SSH?** Glacann Codex agus Grok CLI le comhartha greamaithe > freisin — an cluaisín **Greamaigh Eochair API** / **Iompórtáil auth.json** sa > dialóg naisc. Níl aon aisghlao aisfhillte ag baint leis an gconair sin, mar sin > oibríonn sí ó aon tionscnamh. Ina theannta sin, glacann Codex le comhartha > rochtana lom nó le blob seisiúin `~/.codex/auth.json`. --- ## Comharthaí a bhainistiú ```bash omniroute tokens create --name "laptop" --scope write [--expires 30] # ↳ priontálann sé an rún UAIR AMHÁIN — cóipeáil anois é omniroute tokens list # folaithe: aitheantas, ainm, raon feidhme, réimír, stádas, dul in éag omniroute tokens revoke # cúlghair láithreach omniroute tokens scopes # mínigh na trí raon feidhme ``` Teastaíonn dintiúr **admin** ó orduithe `tokens`. Is féidir leat comharthaí a bhainistiú freisin sa deais faoi **Socruithe → Comharthaí Rochtana** (cruthaigh, cúlghair, cóipeáil uair amháin). Ní féidir comhartha a chruthú riamh le níos mó pribhléide ná mar atá ag a chruthaitheoir. Ní féidir comhartha `admin` a chruthú ach amháin ag an oibreoir — trí sheisiún na deaise, an CLI áitiúil ar an bhfreastalaí féin, `omniroute connect` leis an bhfocal faire, nó ásc a bhfuil logáil isteach díchumasaithe air. Ní féidir le dintiúir mheaisín (comhartha rochtana `admin`, nó eochair API leis an raon feidhme `manage`/`admin`) ach comharthaí `write` agus `read` a chruthú; má iarrtar `--scope admin` orthu, seoltar `403` ar ais. Ní féidir comhartha a chruthú riamh le níos mó pribhléidí ná mar atá ag a chruthaitheoir. Is é an t-oibreoir amháin atá in ann comhartha `admin` a chruthú: trí sheisiún an deais, an CLI áitiúil ar an bhfreastalaí féin, `omniroute connect` leis an bhfocal faire, nó in ásc ina bhfuil logáil isteach díchumasaithe. Ní féidir le dintiúir mheaisín (comhartha rochtana `admin` nó eochair API le scóip `manage`/`admin`) ach comharthaí `write` agus `read` a chruthú; tugann iarratas ar `--scope admin` leo `403` ar ais. --- ## CLI códúcháin a chumrú ón gcatalóg chianda Léann `omniroute configure` catalóg bheo samhlacha an **fhreastalaí ghníomhaigh** agus scríobhann sé cumraíocht ar **do** ríomhaire. ```bash omniroute configure codex # Soláthraithe: glm, kmc, ollamacloud, opencode-go, … # Soláthraí: glm # Aitheantas samhla: glm/glm-5.2 # ✔ Scríobhadh ~/.codex/glm52.config.toml # Úsáid é: codex --profile glm52 # neamh-idirghníomhach omniroute configure codex --provider glm --model glm/glm-5.2 --name glm52 # coinnigh samhail a úsáidtear go minic ag barr an roghnóra idirghníomhaigh omniroute configure codex --provider glm --model glm/glm-5.2 --favorite --yes ``` Ní choinníonn an roghnóir ach aitheantais samhlacha (ní choinníonn sé URLanna ná dintiúir choíche) sa chomhad áitiúil `model-preferences.json`, arna scópáil de réir comhthéacs agus sprice CLI. Taispeántar ceanáin roimh roghanna a rinneadh le déanaí; úsáid `--unfavorite` chun samhail roghnaithe a bhaint den liosta comhthéacs/sprice sin. Tagraíonn an phróifíl scríofa don eochair tátail trí athróg timpeallachta (`OMNIROUTE_API_KEY`) — ní scríobhtar an rún ar diosca choíche. Le haghaidh bunshocrú aonuaire Codex (an bloc `[model_providers.omniroute]`), féach [CODEX-CLI-CONFIGURATION.md](./CODEX-CLI-CONFIGURATION.md). ### CLI a sheoladh i gcoinne an chianfhreastalaí (gan cumraíocht a scríobh) Cloíonn `omniroute run ` leis an gcomhthéacs gníomhach freisin: ní instealltar an bun-URL cianda ná dintiúr an chomhthéacs ach amháin sa phróiseas a sceitear. ```bash omniroute connect 192.168.0.15 omniroute run claude --model openai/gpt-5.4 # Claude Code → cianfhreastalaí omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "hello" omniroute run opencode --model glm/glm-5.2 -- run "reply OK" # Réamhamharc beacht ar an méid a sceithfí (AINMNEACHA EOCHRACHA timpeallachta amháin, luachanna choíche): omniroute run codex --dry-run --json ``` Spriocanna: `claude`, `codex`, `aider`, `goose`, `opencode`, `qwen`, `gemini` (foinse aonair: `bin/cli/cli-manifest.mjs`). Ritheann Qwen agus Gemini le heolaire baile sealadach leithlisithe a bhaintear nuair a scoirtear, mar sin ní bhaineann an seoladh le cumraíocht phearsanta d'uirlise — ná ní sceitheann sé isteach inti — choíche. ### Orduithe socraithe de réir CLI Tá ordú socraithe atá feasach ar an gcianfhreastalaí ag gach CLI a dtacaítear leis (cloíonn siad uile leis an gcomhthéacs gníomhach, nó `--remote --api-key `): | CLI | Ordú | An méid a scríobhann sé | | ----------- | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Codex | `omniroute setup-codex` | próifílí `~/.codex/.config.toml` (ceann amháin in aghaidh na samhla) | | Claude Code | `omniroute setup-claude` | `~/.claude/profiles//settings.json` (ceann amháin in aghaidh na samhla) | | OpenCode | `omniroute setup-opencode` | `~/.config/opencode/opencode.json` — an soláthraí `omniroute` atá comhoiriúnach le openai, le gach samhail sa chatalóg (rith `opencode -m omniroute/`) | | Cline | `omniroute setup-cline` | `~/.cline/data/{globalState,secrets}.json` (mód CLI) + priontálann sé socruithe an eisínteachta VS Code lena ngreamú (comhoiriúnach le OpenAI, Bun-URL **gan** `/v1`) | | Kilo Code | `omniroute setup-kilo` | `~/.local/share/kilo/auth.json` (CLI) + socruithe VS Code `kilocode.*` — comhoiriúnach le OpenAI, Bun-URL **le** `/v1` | | Continue | `omniroute setup-continue` | `~/.continue/config.yaml` (VS Code/JetBrains + CLI `cn`) — `provider: openai`, `apiBase` **le** `/v1`, eochair trí `${{ secrets.OMNIROUTE_API_KEY }}` | | Cursor | `omniroute setup-cursor` | priontálann sé na céimeanna san aip (Settings → Models → Override OpenAI Base URL **le** `/v1` + eochair + samhail). Is SQLite teimhneach é cumraíocht Cursor — painéal comhrá amháin | | Roo Code | `omniroute setup-roo` | scríobhann sé JSON iompórtála Roo (`~/.omniroute/roo-settings.json`) + socraíonn sé `roo-cline.autoImportSettingsPath` + priontálann sé céimeanna UI (comhoiriúnach le OpenAI, Bun-URL **le** `/v1`) | | Crush | `omniroute setup-crush` | `~/.config/crush/crush.json` — soláthraí `openai-compat`, `base_url` **le** `/v1`, eochair trí `$OMNIROUTE_API_KEY` | | Goose | `omniroute setup-goose` | `~/.config/goose/config.yaml` (`GOOSE_PROVIDER=openai` + `OPENAI_HOST` **gan** `/v1` + `GOOSE_MODEL`) + oideas timpeallachta | | Aider | `omniroute setup-aider` | `~/.aider.conf.yml` (`openai-api-base` **gan** `/v1` + `model: openai/`) + oideas timpeallachta (`aider --message --yes`) | | Qwen Code | `omniroute setup-qwen` | iontráil V4 `modelProviders.openai` in `~/.qwen/settings.json` + `OMNIROUTE_API_KEY` in `~/.qwen/.env` | ```bash # OpenCode (soláthraí atá comhoiriúnach le openai, gach samhail sa chatalóg, VPS cianda) omniroute setup-opencode --remote http://192.168.0.15:20128 --api-key oma_live_xxx omniroute setup-opencode --only glm,kimi # ná coinnigh ach samhlacha meaitseála opencode -m omniroute/glm/glm-5.2 "..." # easpórtáil OMNIROUTE_API_KEY ar dtús ``` > Tá comhtháthú **breiseáin** níos saibhre ag OpenCode freisin: `omniroute setup opencode` > (a thacaíonn le cianúsáid anois trí `--remote`) a shuiteálann `@omniroute/opencode-plugin`. > Is é `setup-opencode` an rogha éadrom atá comhoiriúnach le openai. Déantar tagairt > don eochair API trí `{env:OMNIROUTE_API_KEY}` — ní scríobhtar ar diosca riamh í. > > Ar OpenCode v2, úsáid `@omniroute/opencode-plugin-v2` ina ionad: an chatalóg chéanna, > conradh lódála difriúil. Léann sé an eochair ó stór dintiúr OpenCode féin > nuair atá an comhtháthú nasctha, mar sin ní theastaíonn eochair ar bith ó gheata > cianda in `opencode.json`. --- ## Bainistiú comhthéacsanna (athraigh idir freastalaithe) Is freastalaí sábháilte é **comhthéacs** (baseUrl + dintiúr + scóip). Cruthaíonn `omniroute connect` ceann amháin agus déanann sé gníomhach é; as sin amach díríonn gach ordú air. Bainistigh agus athraigh eatarthu le `omniroute contexts`: ```bash omniroute contexts list # gach comhthéacs; tá an ceann gníomhach marcáilte ● omniroute contexts current # an freastalaí gníomhach, stádas fíordheimhnithe, scóip ``` ```text | Ainm | URL Bunúsach | Fíordheimhniú | Scóip | Cur Síos ● | vps | http://100.67.86.91:20128 | comhartha | riarthóir | OmniRoute cianda (…) | réamhshocrú | http://localhost:20128 | ✗ | | ``` **Athraigh freastalaithe** — leanann gach ordú ina dhiaidh sin an comhthéacs gníomhach: ```bash omniroute contexts use vps # → buaileann gach ordú an VPS cianda anois omniroute tokens list # (ritheann sé i gcoinne an VPS) omniroute contexts use default # → ar ais chuig localhost omniroute tokens list # (ritheann sé i gcoinne an fhreastalaí áitiúil) ``` **Cuir comhthéacs leis de láimh** (in ionad `connect`), scrúdaigh, nó athainmnigh: ```bash omniroute contexts add staging --url https://staging.example.com:20128 \ --access-token oma_live_xxxx --scope write --description "bosca stáitse" omniroute contexts show staging # sonraí iomlána do chomhthéacs amháin omniroute contexts rename staging stg ``` **Bain comhthéacs** — iarrann sé deimhniú; cuir `--yes` leis chun é a scipeáil (riachtanach do scripteanna / sliogáin neamh-idirghníomhacha, a dhiúltaíonn go sábháilte ar shlí eile): ```bash omniroute contexts remove stg --yes ``` > Ní féidir `default` (localhost) a bhaint. Má bhaintear an comhthéacs gníomhach, filleann sé ar `default`. Leid: ní bhaineann baint comhthéacs ach an dintiúr sábháilte **áitiúil** — cúlghair an comhartha ar an bhfreastalaí le `omniroute tokens revoke ` chun rochtain a mharú i ndáiríre. **Easpórtáil / Iompórtáil** comhthéacsanna (m.sh. chun iad a bhogadh idir meaisíní). Fágann easpórtálacha dintiúir ar lár de réir réamhshocraithe, lena n-áirítear dintiúir atá stóráilte ag an gcúlchiste comhaid. Bain úsáid as `--include-secrets` go sainráite nuair a bhíonn cúltaca iniompartha a bhfuil dintiúir air ag teastáil: ```bash omniroute contexts export --out contexts.json # curtha in eagar; ceann scríbe réamhshocraithe: stdout omniroute contexts export --include-secrets --out private-contexts.json omniroute contexts import contexts.json # forscríobh; --merge chun na cinn atá ann cheana a choinneáil omniroute contexts migrate --yes # bog comharthaí téacs soiléir oidhreachta chuig an eochairchain ``` Réitíonn `--include-secrets` tagairtí eochairchain sula n-easpórtálann sé agus teipeann air má theipeann ar aon dintiúr tagartha a léamh. Bíonn tosaíocht ag `--no-secrets` i gcónaí. Scríobhtar comhaid easpórtála go adamhach le mód `0600`. Caith le heaspórtáil shainráite a bhfuil rún aici mar ábhar rúnda. Ar chórais gan cheann gan eochairchain OS inúsáidte, filleann an CLI ar `config.json` le mód `0600` agus priontálann sé rabhadh aonuaire; fanann easpórtáil réamhshocraithe curtha in eagar sa mhodh seo. --- ## Seiceáil thapa ó cheann ceann Saolré is féidir a chóipeáil agus a ghreamú chun socrú cianda a fhíorú ón tús — ceangail, eisiúint comhartha faoi raon feidhme, treoraigh ordú, aistrigh ar ais, agus bain an socrú. Cuir óstach/IP d'fhreastalaí in ionad `192.168.0.15` (Tailscale, LAN, nó URL poiblí `https://…`). ```bash # 1. Ceangail (pasfhocal → comhartha admin, sábháilte mar chomhthéacs a éiríonn gníomhach) omniroute connect 192.168.0.15 # nó: --key oma_live_xxxx (gan pasfhocal) omniroute contexts current # taispeánann sé an freastalaí cianda + raon feidhme # 2. Úsáid é — ritear orduithe bainistíochta anois in aghaidh an chinn chianda omniroute tokens create --name laptop --scope read # eisigh comhartha le raon feidhme níos cúinge omniroute tokens list # liosta mascaithe, ón gcianfhreastalaí # 3. Aistrigh anonn is anall omniroute contexts use default # → logánta omniroute contexts use 192-168-0-15 # → cianda arís (ainm ó `contexts list`) # 4. Bain an socrú. TABHAIR FAOI DEARA: ní scriosann `contexts remove` ach an dintiúr LOGÁNTA — # NÍ chúlghaireann sé an comhartha ar an bhfreastalaí. Cúlghair ar thaobh an fhreastalaí é ar dtús más # mian leat rochtain a scor i ndáiríre. omniroute tokens revoke # scoireann sé rochtain ar an bhfreastalaí omniroute contexts remove 192-168-0-15 --yes # bain an comhthéacs logánta (fiú má tá sé gníomhach → filleann sé ar default), gan leid ``` > Déanann `--yes` `contexts remove` neamh-idirghníomhach (riachtanach i scripteanna/CI; gan é, > diúltaíonn blaosc neamh-idirghníomhach go sábháilte in ionad crochadh). Má bhaintear an comhthéacs > **gníomhach**, filleann sé ar `default` go huathoibríoch. --- ## Nótaí slándála - Ní thaispeántar gnáth-théacs an chomhartha ach uair amháin; ní choinnítear ach an hais SHA-256 (mar a dhéantar le heochracha API). - Athúsáideann `omniroute connect` an frithdhúnadh i gcoinne iarrachtaí logála isteach le fórsa brúidiúil agus an logáil iniúchta. - Moltar HTTPS nó Tailnet a úsáid don iompar; úsáidtear `http://` de réir réamhshocraithe le haghaidh óstach lom ar mhaithe le háisiúlacht LAN/Tailscale — tabhair URL iomlán `https://…` le haghaidh TLS. - Is é `~/.omniroute/config.json` (`chmod 600`) an comhad comhthéacs áitiúil is fearr, nach bhfuil ann ach `credentialRef`; stóráiltear an comhartha féin i slabhra eochracha an chórais oibriúcháin (`keytar`) agus ní phriontáiltear i logaí riamh é. Úsáideann suiteálacha gan chomhéadan nach bhfuil slabhra eochracha dúchasach oibre acu an comhad `0600` céanna mar chúltaca sainráite agus eisíonn siad rabhadh uair amháin. Úsáid `omniroute contexts migrate --yes` tar éis duit inneall slabhra eochracha a shuiteáil. --- ## Críochphointí API (tagairt) | Modh | Bealach | Fíordheimhniú | Scóip | | ------ | --------------------- | ----------------------- | ------------------------------------ | | POST | `/api/cli/connect` | pasfhocal bainistíochta | — (poiblí, faoi chosaint pasfhocail) | | GET | `/api/cli/whoami` | comhartha rochtana | léamh | | GET | `/api/cli/tokens` | comhartha rochtana | riarachán | | POST | `/api/cli/tokens` | comhartha rochtana | riarachán | | DELETE | `/api/cli/tokens/:id` | comhartha rochtana | riarachán | Féach [openapi.yaml](../openapi.yaml) le haghaidh na scéimeanna iomlána.