CLI

Pomocí příkazu elowen chatujte v terminálu, spravujte konverzace nebo spusťte jeden neinteraktivní požadavek. Samostatný klient připojí váš počítač k existující instanci Elowen. Plná serverová instalace navíc obsahuje příkazy pro služby a správu.

Připojte svůj počítač

1. Přihlaste se v prohlížeči ke své instanci a otevřete Účet → Počítače.
2. Stránka zkopíruje příkaz pro systém, na kterém běží váš prohlížeč, a uvede, kam jej vložit. Jen když to nedokáže určit, například na telefonu, zobrazí logo Windows a loga Apple a Linux k výběru. Zvolte Kopírovat instalační příkaz a vložte zkopírovaný příkaz do terminálu na počítači, který chcete připojit: ve Windows do PowerShellu, který vyžaduje Windows 10 22H2 nebo Windows 11. Uvnitř WSL použijte linuxový příkaz: otevřete stránku v linuxovém prohlížeči, nebo ji zkopírujte z telefonu s vybranými logy Apple a Linux. Příkaz se na stránce nezobrazuje. Platí 10 minut a funguje jednou; po vypršení zvolte Kopírovat instalační příkaz znovu a získáte nový.
3. Příkaz stáhne klienta pro váš systém, ověří jeho podpis, nainstaluje ho do ~/.local/share/elowen/client, ve Windows do %LOCALAPPDATA%\Elowen\client bez oprávnění správce, a spáruje počítač s vaším účtem. Na nic se neptá. Instalace Node.js ani npm není potřeba.

Poté zůstává počítač připojený k Elowen na pozadí, i po výpadku sítě nebo restartu, a sám se aktualizuje. Práci mu můžete zadat z webu, z telefonu nebo z terminálu. Účet → Počítače vypisuje vaše počítače v jedné kartě, každý na vlastním řádku: zda je připojený, kdy byl naposledy online a od kdy je spárovaný, jeho systém a verzi klienta, aktuální zátěž CPU, paměti a disku, když je na ni místo, a tlačítko pro odebrání. Otevřete řádek a uvidíte jeho běhy, příkazy a náklady za období, které zvolíte vedle grafu a které pak platí pro každý počítač, a jeho aktuální zátěž ve větších kruzích.

Pokud příkaz vypíše řádek export PATH=..., přidejte jej do profilu shellu, aby elowen fungoval v nových terminálech. Ve Windows přidá instalátor klienta do vašeho uživatelského Path sám, takže elowen funguje ve stejném okně PowerShellu i v nových.

Ve Windows spouští nástroj Bash PowerShell: PowerShell 7 (pwsh), pokud je nainstalovaný, jinak Windows PowerShell 5.1, který je součástí Windows. Elowen se dozví, který z nich to je, a píše tam proto příkazy PowerShellu a windowsové cesty. Sestavení pro arm64 zatím nebylo otestováno na skutečném hardwaru.

Povolené operace se soubory a shellem běží s oprávněními vašeho účtu operačního systému na daném počítači a dosáhnou na vše, k čemu má tento účet přístup, nejen na složku, ze které jste začali. Práce pro počítač, který je offline, skončí chybou; nikdy se nepřesune na server.

Připojení na pozadí

V Linuxu instalátor zaregistruje uživatelskou službu elowen-connect.service a povolí ji při každém startu počítače. Pokud to váš systém pro váš účet nedovolí, instalátor vám to sdělí a připojení pak běží jen při přihlášení. V macOS zaregistruje položku pro přihlášení, která se spouští s vaší relací. Když počítač nemá správce uživatelských služeb, například přes SSH bez desktopové relace na Macu, instalátor to oznámí: spusťte v terminálu elowen connect a nechte jej otevřený. Ve Windows přidá záznam do programů spouštěných při přihlášení vašeho účtu, takže se připojení spouští skrytě při každém přihlášení. Pokud se během přihlášení zastaví, spustí se znovu při dalším přihlášení, případně spusťte elowen connect. Jeho log najdete v %LOCALAPPDATA%\Elowen\client\logs\connect.log.

Bez grafického rozhraní a ruční spárování

Chcete-li spárovat zařízení bez instalačního příkazu, například ze staženého archivu, spusťte elowen login. V samostatném klientu vypíše Open <link> to approve this device. Otevřete odkaz v přihlášeném prohlížeči, zkontrolujte název a kód zařízení a zvolte Schválit. Poté spusťte připojení na pozadí pomocí elowen connect. V plné serverové instalaci, když není nastavená ani ELOWEN_URL, ani ELOWEN_DAEMON_URL, vypíše stejný příkaz Open <link> to approve this sign-in. a schválení dá terminálu osobní API token místo spárování počítače; zrušte jej v Účet → API tokeny. Když nastavíte kteroukoli z těchto adresních proměnných, i na adresu loopback, elowen login znovu spáruje počítač.

Odstraňte CLI

elowen uninstall

Tím zrušíte přístup počítače, zastavíte připojení na pozadí a odstraníte klienta, jeho příkaz elowen i uložené přihlášení. Ve Windows odstraní také záznam ve spouštění a položku Path; složka klienta zmizí chvíli po dokončení příkazu. Pokud instanci nelze dosáhnout, počítač se přesto uklidí; poté jej odeberte v Účet → Počítače.

Vyberte instanci

Klient nainstalovaný instalačním příkazem vždy používá instanci, ze které byl nainstalován. Chcete-li dosáhnout jiné instance, nastavte ELOWEN_URL na její veřejnou adresu nebo na její výslovnou adresu /api. CLI přidá /api k veřejnému originu a existující předponu /api ponechá jen jednou. Pokud nasazení používá pro živé připojení samostatnou veřejnou adresu daemonu, nastavte ji také výslovně:

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

Když jsou nastavené obě proměnné, chat a ověřené HTTP požadavky používají veřejné webové API, živé připojení používá výslovně zadaný daemon a uložené přihlášení patří veřejnému originu. Pro přímý přístup k daemonu bez webu nastavte jen ELOWEN_DAEMON_URL na origin daemonu, který vám sdělil administrátor; HTTP pak nemá předponu /api. Když není nastavená ani jedna proměnná, plné serverové CLI používá svůj místní daemon. CLI neodvozuje režim nasazení ani port daemonu z adresy.

Přihlašovací údaje a spárovaná zařízení se ukládají do mezipaměti odděleně podle originu, včetně schématu, hostitele a portu, v ~/.config/elowen/cli-instances.json. Přepnutí na jiný origin použije jeho vlastní přihlášení. Existující přihlášení v cli.json se migruje až po ověření proti vybrané instanci; neúspěšné ověření jej ponechá nedotčené. Migrace starší přihlašovací relace přes webovou adresu /api vyžaduje skutečnou přímou adresu ELOWEN_DAEMON_URL.

Spusťte chat

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

Spusťte elowen v libovolné složce a otevřete chat s uloženým přihlášením daného počítače. Interaktivní chat potřebuje terminál. Klient bez přihlašovacích údajů vás požádá o schválení v prohlížeči.

Používejte interaktivní chat

Napište / a otevře se nabídka dostupných příkazů. Pomocí !command spusťte příkaz shellu v aktuální složce terminálu. Příkaz i výstup se zaznamenají do konverzace pro agenta a vaše další zpráva se odešle tak, jak ji napíšete. Pomocí @path přiložíte soubor nebo obrázek. /editor otevře nakonfigurovaný editor s aktuálním konceptem.

Pomocí /project zvolte, kde konverzace pracuje: na spárovaném počítači, nebo v dostupném serverovém či spravovaném Projektu. Nové konverzace vytvořené spárovaným CLI vždy běží na tomto počítači a pracují ve složce, ze které jste spustili elowen, a načtou instrukce této složky. Pokud připojení počítače na pozadí neběží, spuštění nové konverzace selže se zprávou, která vám řekne, ať je spustíte; konverzace se nikdy místo toho neotevře na serveru. Když elowen spustíte znovu ve stejné složce, pokračujete v této konverzaci. Pokud složka na počítači už neexistuje, Elowen tah odmítne, místo aby pracoval jinde. Obnovení konverzace zachová její stávající cíl, takže konverzace dříve používající serverový Projekt v něm zůstane, dokud ji nezměníte. Výběr ukazuje místní zařízení se stavem připojení a složkou; stavový řádek následuje zvolený cíl.

/cd [path] přesune složku, ve které CLI pracuje: příkazy !, cesty @ a složku, ve které běží nová konverzace na vašem počítači. Nemění zvolený cíl provádění konverzace ani neuděluje přístup k Projektu. Když CLI spustíte z jiné složky, spustí nebo obnoví konverzaci vázanou na tuto složku, proto před odesláním práce zkontrolujte zvolený cíl.

Zprávy odeslané během běžícího tahu čekají ve frontě. Stiskněte dvakrát Esc v rámci okna pro přerušení a tah zastavíte. Stisknutím Ctrl+B přesunete způsobilou delegovanou práci, workflow nebo příkazy shellu z popředí na pozadí. V zobrazení sub-agenta vrátí Esc do rodičovské konverzace; stiskněte Ctrl+X a potom s pro zastavení relace, kterou sledujete, nebo Ctrl+X a potom k pro zastavení běžícího sub-agenta, aniž byste opustili konverzaci, kterou čtete. Klávesové zkratky CLI vypisují všechny výchozí zkratky a jak je změnit.

Pomocí /plan, /build nebo /workflow zvolte režim pro další zprávy. Režimy neudělují další oprávnění. Stisknutím Ctrl+O přepínáte mezi rodičovskou konverzací a podřízenými relacemi.

Vybírejte a spravujte konverzace

/sessions
/resume
/rename
/export

Pomocí /compact shrnete starší historii, /stats zobrazí informace o relaci, modelu, spotřebě a kontextu a /context rozpis kontextu CLI.

Spusťte neinteraktivní požadavek

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

Mezi užitečné volby patří --model, --provider, --continue, --resume, --new, --mode plan|build|workflow, --goal, --max-turns, --list, --json, --verbose a --timeout. Podrobnosti najdete v elowen run --help. Běh bez interaktivního terminálu nedokáže odpovídat na otázky. Když se tah na něco zeptá, běh vypíše otázku s [needs input] a skončí s kódem 5.

Prompt začínající / spustí slash příkaz:

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

Volejte API

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

Příkaz API přijímá metodu, cestu a volitelné tělo JSON a používá zvolenou instanci a přihlašovací údaj.

Aktualizace samostatného klienta

Když otevřete chat, samostatný klient zkontroluje u své instance novější podepsané vydání klienta. Pokud nějaké existuje, zeptá se, zda aktualizovat nyní nebo později. Volba aktualizovat nyní jej ověří, nainstaluje a poté spustí chat v nové verzi. Volba později spustí chat v nainstalované verzi a zeptá se znovu při příštím spuštění. Neúspěšná instalace obnoví předchozího klienta; neúspěšná kontrola vydání ohlásí chybu a chat ukončí. Běh, požadavky API, přihlášení, nápověda ani zobrazení verze se nekontrolují. Připojení na pozadí se aktualizuje samo bez dotazování: zkontroluje se krátce po spuštění a poté každých 30 minut, když neběží žádný příkaz, novější vydání nainstaluje tiše a na novou verzi přejde zhruba minutu po dokončení posledního příkazu, takže běžící příkaz nikdy nepřeruší. Přechází i na aktualizaci, kterou jste přijali v chatu.

Správa serverové instalace

Tyto příkazy patří k plné serverové instalaci a v samostatném stažení nejsou dostupné. Správu služeb spouštějte na stroji, který hostuje Elowen; volba vzdálené instance pomocí ELOWEN_URL z nich neudělá ovládání vzdálených služeb.

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

Příkazy služeb spravují místní instalaci Elowen. Běžné down požádá o klidné zastavení a počká, až procesy skončí. --force je ukončí okamžitě, takže běžící práce se opustí. elowen update aktualizuje serverovou instalaci.

elowen restart daemon požádá běžící daemon, aby uložil obnovitelnou práci a restartoval se. Práce pokračuje, až daemon znovu nastartuje. Pokud daemon neodpovídá, příkaz se uchýlí k systemctl. elowen restart web používá vždy systemctl.

Spusťte sudo elowen privileged refresh jako root v Linuxu, když zpráva hlásí odchýlené nebo chybějící privilegované soubory vlastněné rootem, případně nenainstalované jednotky workeru. Příkaz znovu nainstaluje tyto soubory a jednotky z běžícího vydání a jen když se něco změnilo, zastaví privilegovaný worker, počká na dokončení jeho běžících operací, nahradí soubory a znovu jej spustí. Pokud některý krok selže, worker zůstane zastavený a příkaz vám řekne, ať jej spustíte znovu.