Sve upute

Geslar CLI, agenti i automatizacija

Pristup Škrinji iz terminala, za AI agente (uz odobrenje osobe) i CI poslove.

Ažurirano

Za koga je Geslar CLI

Geslar CLI (naredba geslar) čita tajne iz vaše Škrinje, pokreće naredbe s tajnama u okruženju procesa i daje AI alatima i CI poslovima usko ograničen pristup Škrinjama koje odaberete. Dešifriranje se događa na vašem računalu; poslužitelj nikad ne vidi vrijednosti tajni. Svako čitanje stavke bilježi se u revizijski zapis — vašeg računa ili organizacije kojoj Škrinja pripada. Dostupno uz Premium, Obitelj, Poslovni ili Enterprise plan; agenti i servisni računi trebaju plan koji ih uključuje (vidi „Paketi i limiti”).

Instalacija

npm install -g @geslar/cli — treba Node.js 22 ili noviji. CLI se distribuira samo preko npm-a. Provjera: geslar --version. Detalji i pohrana lokalnog ključa → docs.geslar.app/cli/install.

Prijava kao osoba

geslar login otvara preglednik, gdje se prijavljujete kao i inače i odobravate CLI. Bez preglednika (npr. SSH) postoji geslar login --device: ispiše kod i poveznicu, a vi na drugom uređaju sami upisujete kod. Prijavu kodom uređaja možete isključiti u postavkama. Prijava dokazuje tko ste; Škrinju ne otključava. Cijeli vodič → docs.geslar.app/cli/quickstart.

Otključavanje

geslar unlock traži glavnu lozinku u terminalu (nikad iz varijable okruženja, argumenta ili datoteke) i drži Škrinju otključanom 30 minuta, a najviše 8 sati (--ttl 1h); zaključava se i nakon 15 minuta bez korištenja. geslar lock je zaključava odmah. Uz --unlock lozinku unosite samo za jednu naredbu i ništa se ne sprema. Bez otključavanja read, run i inject završavaju greškom (izlazni kod 6). Detalji → docs.geslar.app/cli/quickstart.

geslar:// adrese

Stavke u Škrinji adresiraju se oblikom geslar://<škrinja>/<stavka>/<polje> — škrinja po imenu ili posebnoj riječi poput personal/family/company (pod profilom agenta i sa servisnim računom samo po imenu). Polje je po zadanom password. Dvosmislen naziv je uvijek greška s popisom kandidata, nikad tihi izbor. Puna gramatika i primjeri → docs.geslar.app/cli/reference.

Pokretanje naredbi

geslar run razrješava geslar:// reference i pokreće vašu naredbu s vrijednostima u okruženju procesa; ako ijedna referenca ne uspije, naredba se ne pokreće. Ispis naredbe po zadanom je maskiran, ali maskiranje skriva samo doslovnu vrijednost, ne kodirane oblike (npr. base64). geslar inject ispisuje retke KLJUČ=vrijednost za source ili dotenv, a taj ispis nije maskiran. U PowerShellu -- stavite u navodnike ('--'). Primjer i pravila → docs.geslar.app/cli/quickstart.

Agenti i odobrenja

Agent je strojni identitet s načinom „Agent (AI alat)”. Stvarate ga u Škrinjaru na webu (Postavke → Agenti i automatizacija → Agenti i CI): birate Škrinje do kojih smije doći i trajanje, a aplikacija jednom prikaže njegov token (gsm_…). Agent nikad ne vidi vašu lozinku ni druge Škrinje; može popisati nazive i vrste stavki u Škrinjama koje mu date, nikad njihove vrijednosti. Preporuka: napravite zasebnu Škrinju samo za agenta.

Profil agenta na računalu spremate s geslar agent add <ime> (token se upisuje u skriveni upit, u roku od 15 minuta od stvaranja). Pod profilom agent ne može ispisati vrijednost: read i inject su odbijeni, a run radi samo za naredbu koju ste dopustili, uvijek uz maskiranje i uz razlog koji vidi osoba koja odobrava.

Granica je odobrenje na poslužitelju. Kad agent treba čitati stavke Škrinje, a nema važeće odobrenje, osoba mora odobriti: run staje s izlaznim kodom 8, ispiše poveznicu i kratki kod i ništa ne pokreće. Odobravate lozinkom i svježim 2FA kodom, svaki put, i smijete odobriti manje nego što je traženo, nikad više. Odobrenje vrijedi ograničeno vrijeme i za ograničen broj čitanja. CLI ne čeka odluku i ne može ništa odobriti ni odbiti. Detalji → docs.geslar.app/cli/agents.

MCP: AI klijenti

geslar mcp serve je stdio MCP poslužitelj nad profilom agenta. Može ga koristiti bilo koji MCP klijent koji pokreće lokalni stdio poslužitelj; geslar mcp init sam upisuje konfiguraciju za Claude Code, Claude Desktop i Cursor, a za sve ostale ispisuje zapis koji možete ugraditi. Zapis nikad ne sadrži token.

Poslužitelj nudi pet alata: geslar_list_vaults, geslar_list_items (samo nazivi i vrste), geslar_whoami, geslar_provision_env (upisuje reference KEY=geslar://…, nikad vrijednosti) i geslar_run (pokreće program s tajnama u njegovu okruženju, a modelu vraća samo izlazni kod, trajanje i broj redaka ispisa). Naredbe koje agent smije pokretati dopuštate vi, u terminalu, s geslar mcp allow-cmd. Obrazac naredbe nije sigurnosna granica: naredba koja može izvršiti proizvoljan kod može poslati tajne iz svog okruženja dalje.

Geslar MCP poslužitelj nema verziju na internetu, namjerno: vaše se tajne dešifriraju samo na vašem računalu, pa poslužitelj mora raditi ondje. Chat aplikacije koje rade samo u pregledniku ili u oblaku ne mogu ga pokrenuti; koristite klijent koji radi na vašem računalu. Claude Desktop na Windowsu još nije provjeren na stvarnom klijentu. Detalji → docs.geslar.app/cli/mcp.

CI i GitHub Action

CI posao koristi servisni račun (način „Servis (CI)” u istim postavkama) i njegov token, koji dajete poslu kao varijablu okruženja GESLAR_SERVICE_TOKEN iz tajni vašeg CI sustava. Sesija živi samo u memoriji, bez prijave, otključavanja i terminala. Opseg i istek računa su odobrenje, pa se ne traži odobrenje po čitanju. Preporuka: jedan servisni račun po repozitoriju, samo za čitanje, s najkraćim rokom koji vam odgovara.

Za GitHub postoji geslar-eu/secrets-action, koja učitava tajne u posao maskirane. Akciju pinirajte po punom SHA commita, a verziju CLI-ja navedite točno (najmanje 1.0.0). Detalji → docs.geslar.app/cli/ci.

Paketi i limiti

Prijava kao osoba treba Premium, Obitelj, Poslovni ili Enterprise plan; Besplatni plan je ne uključuje. Agenti i servisni računi trebaju isti plan, a njihov je broj ograničen; broje se zajedno, a samo oni koji nisu opozvani ni istekli:

  • Besplatni: 0
  • Premium: 5
  • Obitelj: 5 (samo platitelj)
  • Poslovni: 20
  • Enterprise: 50

Kod Premiuma i Obitelji limit vrijedi po osobi, a kod Poslovnog i Enterprisea po organizaciji. Kod Obitelji agente i servisne račune ima samo osoba koja plaća; član obitelji ih ima samo uz vlastiti plaćeni plan. Plan se provjerava pri svakoj upotrebi identiteta: kad istekne, identitet prestaje raditi.

Što vidi poslužitelj

Poslužitelj ne vidi vrijednosti tajni. Svako čitanje stavke zapisuje se u revizijski zapis — vašeg računa ili organizacije kojoj Škrinja pripada.

Ključna ograničenja

Dok je vaša Škrinja otključana, sve što radi kao vi može je koristiti, uključujući AI agenta s pristupom vašem terminalu. Svaki proces na vašem računu može pokrenuti geslar read, run ili inject kao vi, bez odobrenja i bez profila agenta: profil agenta i odobrenja štite Škrinju samo od agenta koji nema i vašu otključanu sesiju. Zaključajte s geslar lock prije nego agentu dopustite rad u terminalu ili pokrenite agenta pod zasebnim korisnikom operacijskog sustava.

Maskiranje skriva samo doslovnu vrijednost, ne kodirane oblike. U repu ispisa koji --return-stdout-tail daje modelu vrijednosti kraće od 6 znakova nikad se ne maskiraju; geslar run maskira vrijednost bilo koje duljine. Naredba koju pokrenete s geslar run dobiva tajne u svoje okruženje, a istom ih korisniku operacijskog sustava mogu pročitati i drugi procesi. Nema rada bez mreže. Puni popis → docs.geslar.app/cli/limitations.

Niste našli odgovor? Pišite nam