CLI

Pomocou príkazu elowen chatujte v termináli, spravujte konverzácie alebo spustite jednu neinteraktívnu požiadavku. Samostatný klient pripojí váš počítač k existujúcej inštancii Elowen. Plná serverová inštalácia navyše obsahuje príkazy pre služby a správu.

Pripojte svoj počítač

1. Prihláste sa v prehliadači k svojej inštancii a otvorte Účet → Počítače.
2. Stránka skopíruje príkaz pre systém, na ktorom beží váš prehliadač, a uvedie, kam ho vložiť. Len keď to nedokáže určiť, napríklad na telefóne, zobrazí logo Windows a logá Apple a Linux na výber. Zvoľte Kopírovať inštalačný príkaz a vložte skopírovaný príkaz do terminálu na počítači, ktorý chcete pripojiť: v systéme Windows do PowerShellu, ktorý vyžaduje Windows 10 22H2 alebo Windows 11. Vnútri WSL použite linuxový príkaz: otvorte stránku v linuxovom prehliadači alebo ju skopírujte z telefónu s vybranými logami Apple a Linux. Príkaz sa na stránke nezobrazuje. Platí 10 minút a funguje raz; po vypršaní zvoľte Kopírovať inštalačný príkaz znova a získate nový.
3. Príkaz stiahne klienta pre váš systém, overí jeho podpis, nainštaluje ho do ~/.local/share/elowen/client, v systéme Windows do %LOCALAPPDATA%\Elowen\client bez oprávnení správcu, a spáruje počítač s vaším účtom. Na nič sa nepýta. Inštalácia Node.js ani npm nie je potrebná.

Potom zostáva počítač pripojený k Elowen na pozadí, aj po výpadku siete alebo reštarte, a sám sa aktualizuje. Prácu mu môžete zadať z webu, z telefónu alebo z terminálu. Účet → Počítače vypisuje vaše počítače v jednej karte, každý na vlastnom riadku: či je pripojený, kedy bol naposledy online a od kedy je spárovaný, jeho systém a verziu klienta, aktuálne zaťaženie CPU, pamäte a disku, keď je naň miesto, a tlačidlo na odobratie. Otvorte riadok a uvidíte jeho behy, príkazy a náklady za obdobie, ktoré zvolíte vedľa grafu a ktoré potom platí pre každý počítač, a jeho aktuálne zaťaženie vo väčších kruhoch.

Ak príkaz vypíše riadok export PATH=..., pridajte ho do profilu shellu, aby elowen fungoval v nových termináloch. V systéme Windows pridá inštalátor klienta do vášho používateľského Path sám, takže elowen funguje v tom istom okne PowerShellu aj v nových.

V systéme Windows spúšťa nástroj Bash PowerShell: PowerShell 7 (pwsh), ak je nainštalovaný, inak Windows PowerShell 5.1, ktorý je súčasťou systému Windows. Elowen sa dozvie, ktorý z nich to je, a píše tam preto príkazy PowerShellu a windowsové cesty. Zostavenie pre arm64 zatiaľ nebolo otestované na skutočnom hardvéri.

Povolené operácie so súbormi a shellom bežia s oprávneniami vášho účtu operačného systému na danom počítači a dosiahnu na všetko, ku čomu má tento účet prístup, nielen na priečinok, z ktorého ste začali. Práca pre počítač, ktorý je offline, skončí chybou; nikdy sa nepresunie na server.

Pripojenie na pozadí

V Linuxe inštalátor zaregistruje používateľskú službu elowen-connect.service a povolí ju pri každom štarte počítača. Ak to váš systém pre váš účet nedovolí, inštalátor vám to oznámi a pripojenie potom beží len pri prihlásení. V macOS zaregistruje položku na prihlásenie, ktorá sa spúšťa s vašou reláciou. Keď počítač nemá správcu používateľských služieb, napríklad cez SSH bez desktopovej relácie na Macu, inštalátor to oznámi: spustite v termináli elowen connect a nechajte ho otvorený. V systéme Windows pridá záznam do programov spúšťaných pri prihlásení vášho účtu, takže sa pripojenie spúšťa skryte pri každom prihlásení. Ak sa počas prihlásenia zastaví, spustí sa znova pri ďalšom prihlásení, prípadne spustite elowen connect. Jeho log nájdete v %LOCALAPPDATA%\Elowen\client\logs\connect.log.

Bez grafického rozhrania a ručné spárovanie

Ak chcete spárovať zariadenie bez inštalačného príkazu, napríklad zo stiahnutého archívu, spustite elowen login. V samostatnom klientovi vypíše Open <link> to approve this device. Otvorte odkaz v prihlásenom prehliadači, skontrolujte názov a kód zariadenia a zvoľte Schváliť. Potom spustite pripojenie na pozadí pomocou elowen connect. V plnej serverovej inštalácii, keď nie je nastavená ani ELOWEN_URL, ani ELOWEN_DAEMON_URL, vypíše ten istý príkaz Open <link> to approve this sign-in. a schválenie dá terminálu osobný API token namiesto spárovania počítača; zrušte ho v Účet → API tokeny. Keď nastavíte ktorúkoľvek z týchto adresových premenných, aj na adresu loopback, elowen login znova spáruje počítač.

Odstráňte CLI

elowen uninstall

Tým zrušíte prístup počítača, zastavíte pripojenie na pozadí a odstránite klienta, jeho príkaz elowen aj uložené prihlásenie. V systéme Windows odstráni aj záznam v spúšťaní a položku Path; priečinok klienta zmizne chvíľu po dokončení príkazu. Ak sa inštancia nedá dosiahnuť, počítač sa napriek tomu uprace; potom ho odoberte v Účet → Počítače.

Vyberte inštanciu

Klient nainštalovaný inštalačným príkazom vždy používa inštanciu, z ktorej bol nainštalovaný. Ak chcete dosiahnuť inú inštanciu, nastavte ELOWEN_URL na jej verejnú adresu alebo na jej výslovnú adresu /api. CLI pridá /api k verejnému originu a existujúcu predponu /api ponechá len raz. Ak nasadenie používa pre živé pripojenie samostatnú verejnú adresu daemona, nastavte ju tiež výslovne:

export ELOWEN_URL=https://elowen.example/api
export ELOWEN_DAEMON_URL=https://daemon.example

Keď sú nastavené obe premenné, chat a overené HTTP požiadavky používajú verejné webové API, živé pripojenie používa výslovne zadaný daemon a uložené prihlásenie patrí verejnému originu. Pre priamy prístup k daemonovi bez webu nastavte len ELOWEN_DAEMON_URL na origin daemona, ktorý vám oznámil administrátor; HTTP potom nemá predponu /api. Keď nie je nastavená ani jedna premenná, plné serverové CLI používa svoj miestny daemon. CLI neodvodzuje režim nasadenia ani port daemona z adresy.

Prihlasovacie údaje a spárované zariadenia sa ukladajú do vyrovnávacej pamäte oddelene podľa originu, vrátane schémy, hostiteľa a portu, v ~/.config/elowen/cli-instances.json. Prepnutie na iný origin použije jeho vlastné prihlásenie. Existujúce prihlásenie v cli.json sa migruje až po overení voči vybranej inštancii; neúspešné overenie ho ponechá nedotknuté. Migrácia staršej prihlasovacej relácie cez webovú adresu /api vyžaduje skutočnú priamu adresu ELOWEN_DAEMON_URL.

Spustite chat

elowen
elowen chat
elowen chat -c
elowen chat --session <id>
elowen login

Spustite elowen v ľubovoľnom priečinku a otvorte chat s uloženým prihlásením daného počítača. Interaktívny chat potrebuje terminál. Klient bez prihlasovacích údajov vás požiada o schválenie v prehliadači.

Používajte interaktívny chat

Napíšte / a otvorí sa ponuka dostupných príkazov. Pomocou !command spustite príkaz shellu v aktuálnom priečinku terminálu. Príkaz aj výstup sa zaznamenajú do konverzácie pre agenta a vaša ďalšia správa sa odošle tak, ako ju napíšete. Pomocou @path pripojíte súbor alebo obrázok. /editor otvorí nakonfigurovaný editor s aktuálnym konceptom.

Pomocou /project zvoľte, kde konverzácia pracuje: na spárovanom počítači alebo v dostupnom serverovom či spravovanom Projekte. Nové konverzácie vytvorené spárovaným CLI vždy bežia na tomto počítači a pracujú v priečinku, z ktorého ste spustili elowen, a načítajú inštrukcie tohto priečinka. Ak pripojenie počítača na pozadí nebeží, spustenie novej konverzácie zlyhá so správou, ktorá vám povie, aby ste ho spustili; konverzácia sa nikdy namiesto toho neotvorí na serveri. Keď elowen spustíte znova v tom istom priečinku, pokračujete v tejto konverzácii. Ak priečinok na počítači už neexistuje, Elowen ťah odmietne, namiesto toho, aby pracoval inde. Obnovenie konverzácie zachová jej existujúci cieľ, takže konverzácia predtým používajúca serverový Projekt v ňom zostane, kým ju nezmeníte. Výber ukazuje miestne zariadenia so stavom pripojenia a priečinkom; stavový riadok nasleduje zvolený cieľ.

/cd [path] presunie priečinok, v ktorom CLI pracuje: príkazy !, cesty @ a priečinok, v ktorom beží nová konverzácia na vašom počítači. Nemení zvolený cieľ vykonávania konverzácie ani neudeľuje prístup k Projektu. Keď CLI spustíte z iného priečinka, spustí alebo obnoví konverzáciu viazanú na tento priečinok, preto pred odoslaním práce skontrolujte zvolený cieľ.

Správy odoslané počas bežiaceho ťahu čakajú vo fronte. Stlačte dvakrát Esc v rámci okna na prerušenie a ťah zastavíte. Stlačením Ctrl+B presuniete spôsobilú delegovanú prácu, workflow alebo príkazy shellu z popredia na pozadie. V zobrazení sub-agenta vráti Esc do rodičovskej konverzácie; stlačte Ctrl+X a potom s na zastavenie relácie, ktorú sledujete, alebo Ctrl+X a potom k na zastavenie bežiaceho sub-agenta bez toho, aby ste opustili konverzáciu, ktorú čítate. Klávesové skratky CLI vypisujú všetky predvolené skratky a ako ich zmeniť.

Pomocou /plan, /build alebo /workflow zvoľte režim pre ďalšie správy. Režimy neudeľujú ďalšie oprávnenia. Stlačením Ctrl+O prepínate medzi rodičovskou konverzáciou a podriadenými reláciami.

Vyberajte a spravujte konverzácie

/sessions
/resume
/rename
/export

Pomocou /compact zhrniete staršiu históriu, /stats zobrazí informácie o relácii, modeli, spotrebe a kontexte a /context rozpis kontextu CLI.

Spustite neinteraktívnu požiadavku

elowen run "summarize the failing tests"
elowen -p "review this diff"
elowen run --json "inspect the project"
elowen run --mode plan "propose a migration"
elowen run --goal "finish the cleanup" --max-turns 12

Medzi užitočné voľby patria --model, --provider, --continue, --resume, --new, --mode plan|build|workflow, --goal, --max-turns, --list, --json, --verbose a --timeout. Podrobnosti nájdete v elowen run --help. Beh bez interaktívneho terminálu nedokáže odpovedať na otázky. Keď sa ťah na niečo opýta, beh vypíše otázku s [needs input] a skončí s kódom 5.

Prompt začínajúci / spustí slash príkaz:

elowen -p "/stats"
elowen -p "/goal pause"

Volajte API

elowen api GET /projects
elowen api GET /brain/status
elowen api POST /some/route '{"key":"value"}'

Príkaz API prijíma metódu, cestu a voliteľné telo JSON a používa zvolenú inštanciu a prihlasovací údaj.

Aktualizácie samostatného klienta

Keď otvoríte chat, samostatný klient skontroluje pri svojej inštancii novšie podpísané vydanie klienta. Ak nejaké existuje, opýta sa, či aktualizovať teraz alebo neskôr. Voľba aktualizovať teraz ho overí, nainštaluje a potom spustí chat v novej verzii. Voľba neskôr spustí chat v nainštalovanej verzii a opýta sa znova pri ďalšom spustení. Neúspešná inštalácia obnoví predchádzajúceho klienta; neúspešná kontrola vydania ohlási chybu a chat ukončí. Beh, požiadavky API, prihlásenie, pomoc ani zobrazenie verzie sa nekontrolujú. Pripojenie na pozadí sa aktualizuje samo bez vypytovania: skontroluje sa krátko po spustení a potom každých 30 minút, keď nebeží žiadny príkaz, novšie vydanie nainštaluje potichu a na novú verziu prejde približne minútu po dokončení posledného príkazu, takže bežiaci príkaz nikdy nepreruší. Prechádza aj na aktualizáciu, ktorú ste prijali v chate.

Správa serverovej inštalácie

Tieto príkazy patria k plnej serverovej inštalácii a v samostatnom stiahnutí nie sú dostupné. Správu služieb spúšťajte na stroji, ktorý hostuje Elowen; voľba vzdialenej inštancie pomocou ELOWEN_URL z nich neurobí ovládanie vzdialených služieb.

elowen setup
elowen doctor
elowen up
elowen down
elowen status
elowen restart all
elowen update
sudo elowen privileged refresh

Príkazy služieb spravujú miestnu inštaláciu Elowen. Bežné down požiada o pokojné zastavenie a počká, kým procesy skončia. --force ich ukončí okamžite, takže bežiaca práca sa opustí. elowen update aktualizuje serverovú inštaláciu.

elowen restart daemon požiada bežiaci daemon, aby uložil obnoviteľnú prácu a reštartoval sa. Práca pokračuje, keď daemon znova naštartuje. Ak daemon neodpovedá, príkaz sa uchýli k systemctl. elowen restart web používa vždy systemctl.

Spustite sudo elowen privileged refresh ako root v Linuxe, keď správa hlási odchýlené alebo chýbajúce privilegované súbory vlastnené rootom, prípadne nenainštalované jednotky workeru. Príkaz znova nainštaluje tieto súbory a jednotky z bežiaceho vydania a len keď sa niečo zmenilo, zastaví privilegovaný worker, počká na dokončenie jeho bežiacich operácií, nahradí súbory a znova ho spustí. Ak niektorý krok zlyhá, worker zostane zastavený a príkaz vám povie, aby ste ho spustili znova.