DOKUMENTÁCIA
Ako funguje sinep.dev
Prehliadka všetkých častí sinep.dev: čo robia, ako ich používať a na čo pamätať.
Začíname
sinep.dev je dostupný na pozvánku. Keď máte účet, prihláste sa na sinep.dev cez jednotné prihlásenie vašej firmy alebo e-mailom a heslom, ktoré ste dostali.
- Pripojte svoju git platformu v Settings → git integrations alebo pridajte SSH kľúč v Settings.
- Vytvorte pracovný priestor z repozitára. Jeho virtuálny stroj sa spustí za pár sekúnd.
- Prihláste CLI nástroje agentov do svojich účtov v Settings → agents a potom spustite agenta v pracovnom priestore.
- Ak chcete notifikácie a widgety, nainštalujte si aplikáciu pre iOS alebo desktop.
Pracovné priestory
Pracovný priestor je jeden projekt s vlastným virtuálnym strojom: Kata microVM s vlastným jadrom, plnou sadou linuxových nástrojov a pripojenými súbormi iba tohto projektu. Agenti v jednom pracovnom priestore nevidia iný pracovný priestor, iného používateľa ani hostiteľský server.
- Súbory, konverzácie agentov a váš domovský adresár prežijú reštart virtuálneho stroja.
- Vo vnútri je k dispozícii rootless podman, takže agenti môžu zostavovať a testovať obrazy kontajnerov. Docker socket tu nie je.
- Každý pracovný priestor má limity pamäte, CPU a procesov a každý účet má diskovú kvótu. Agent, ktorý uviazne v slučke, spomalí iba sám seba.
- Pracovný priestor, ktorý práve nepoužívate, zmrazte a uvoľnite tak jeho pamäť. Súbory zostanú a agenti, ktorí bežali, sa po rozmrazení obnovia.
- Tailscale pre pracovný priestor (voliteľný) umožní agentom dostať sa do firemnej siete cez váš vlastný tailnet, s prístupom riadeným vašimi Tailscale ACL.
Agenti a terminály
Claude Code, Codex a OpenCode bežia v skutočných termináloch v pracovnom priestore. Každý terminál žije v relácii tmux, takže zatvorenie karty prehliadača ani výpadok spojenia nič nezastaví.
- Spúšťajte toľko agentov, koľko zdroje pracovného priestoru dovolia, každého vo vlastnej karte.
- Stránka Agents zobrazuje každého agenta v každom pracovnom priestore: či pracuje, čaká na vás alebo je hotový.
- Inštrukcie, skills a MCP servery, ktoré nastavíte v Settings → agents, dostanú všetci vaši agenti.
- MCP server sinep.dev umožňuje agentom otvárať súbory a diffy vo vašom prehliadači, klásť vám rozhodnutia, posielať odkazy na náhľad a ak to dovolíte, aj čítať a písať vaše chaty.
Kontrola kódu a git
Všetko, čo agent zmení, sa zobrazí v paneli kontroly, súbor po súbore, so zvýraznením na úrovni slov.
- Pridajte do stage celý súbor, jeden blok zmien alebo jediný riadok a potom commitnite so správou.
- Pushujte, pullujte a otvárajte pull či merge requesty na GitHube, GitLabe alebo Forgejo. Tieto operácie bežia na serveri s vašimi uloženými prístupovými údajmi, nie v pracovnom priestore.
- Kontrolné body vám umožnia vrátiť sa do stavu pred ťahom agenta.
- Voľné úpravy sú vždy povolené: zmenu nikdy nemusíte robiť cez agenta.
Plány s pôvodom
Pri väčšej práci môžete napísať plán a aplikovať ho ako migráciu. sinep.dev vytvorí vetvu, spustí agenta s plánom, spustí vaše akceptačné príkazy a výsledok commitne.
- Každý commit zaznamenáva, ktorý plán, agent, model a relácia ho vytvorili. Celý prepis sa uchováva v git notes, takže aj čerstvý klon obsahuje celú históriu.
- Plán sa nikdy nezopakuje deterministicky. Opätovné spustenie je re-roll: nová vetva a nový záznam, nikdy nie prepísanie.
- Ak niečo zlyhá, vetva aj pracovný strom zostanú, aby ste ich mohli preskúmať alebo prevziať. Cieľová vetva sa nikdy nezmení.
Rozhodnutia a poznámky
Agent, ktorý vás potrebuje, sa nezastaví a nečaká v termináli, ktorý nesledujete. Zaznamená rozhodnutie: otázku, kontext a dve až päť možností so svojím odporúčaním. Potom pokračuje v tom, čo od odpovede nezávisí.
- Odpovedzte zo stránky Agents, z push notifikácie alebo zo zamknutej obrazovky iOS. Odpoveď sa agentovi vpíše späť.
- Zásahy sú úlohy, ktoré zvládne iba človek, napríklad niekde sa prihlásiť alebo pridať DNS záznam. Označíte ich ako hotové a agent si to overí a pokračuje.
- Poznámky vám oznamujú, čo agent urobil a o čom by ste mali vedieť, napríklad nasadenie, bez toho, aby sa na čokoľvek pýtal.
- Ak má rozhodnúť niekto bez účtu, pošlite mu odkaz na jedno rozhodnutie. Uvidí iba túto otázku.
- Agenti sa nikdy nepýtajú na heslo či kľúč cez rozhodnutie. Tajomstvá patria tam, kam patria, napríklad do Settings → workspace credentials.
Asistent
Asistent je váš vlastný agent vo vlastnom pracovnom priestore, nastavený v Agents → assistant. Vidí vašich agentov v iných pracovných priestoroch a môže do nich písať, čo bežní agenti nikdy nedokážu.
- Požiadajte ho o spustenie úlohy: spustí agenta na vlastnej vetve a v samostatnom checkoute.
- Čaká na agentov, ktorým zadal prácu, a hlási ich výsledky, prípadne vám dá vedieť, keď sa niektorý zasekne.
- Ak to dovolíte, môže odpovedať na rozhodnutia v rámci pravidiel, ktoré ste napísali. Každú odpoveď aj tak uvidíte.
- Správy z chatov alebo od iných agentov k nemu prichádzajú označené ako dáta. Koná iba na základe vašich slov a vašich pravidiel.
Úlohy
Úloha je správa, ktorú ste napísali a ktorá sa vpíše asistentovi, všetkým vašim agentom, agentom jedného pracovného priestoru alebo jednému agentovi. Spustí sa, keď sa aktivuje niektorý z jej spúšťačov.
- Plán: cron výraz vo vašom časovom pásme, najčastejšie každých päť minút.
- Webhook: externá služba zavolá tajnú URL úlohy. Text, ktorý pošle, sa pridá, len ak ste to povolili, a je označený ako dáta zvonka.
- Chat: neprečítaná správa zodpovedá vášmu pravidlu, napríklad priama správa, zmienka, kľúčové slovo, odosielateľ alebo podmienka opísaná bežnými slovami. Správy, ktoré prídu naraz, sa doručia v jednom spustení.
- Inzyde: udalosť vo vašej organizácii v Inzyde, napríklad vytvorenie alebo dokončenie úlohy.
Spúšťač rozhoduje iba o tom, kedy sa úloha spustí. Cieľ aj správa sú vždy vaše a každá úloha má obmedzené, ako často sa môže spustiť.
Chaty
Pripojte svoje chatové účty v Settings → chats a čítajte ich všetky v jednej schránke: Matrix (vrátane šifrovaných miestností), Slack, Microsoft Teams, Signal, Telegram, WhatsApp Business a Gmail. Pre každú službu môžete pripojiť viacero účtov.
- Agenti môžu cez MCP nástroje sinep.dev nájsť konverzáciu, prečítať ju a odpovedať v nej vaším menom. E-maily sa agentom nikdy neposkytujú.
- Návrhy odpovedí: v konverzáciách, ktoré si vyberiete, sinep pripraví odpoveď alebo reakciu a počká na vaše kliknutie.
- Konanie bez opýtania je samostatný prepínač pre každú konverzáciu s prísnymi limitmi na to, čo a ako často.
- Správy sa vždy spracúvajú ako slová iných ľudí, nikdy ako pokyny.
Odkazy na náhľad
Webová aplikácia bežiaca v pracovnom priestore, napríklad vývojový server alebo API, dostane súkromný odkaz z ponuky portov. Odkaz vám môže poslať aj sám agent.
- Odkazy platia jednu hodinu a v ponuke portov ich môžete kedykoľvek zrušiť.
- Náhľady sa poskytujú z oddelenej domény, takže kód v náhľade nikdy nemôže na sinep.dev konať vo vašom mene.
Prístupové údaje
Prístupové údaje ku gitu predvolene zostávajú na serveri a git operácie spustené tlačidlami bežia tam. Ak chcete, aby git, cloudové CLI alebo iné nástroje fungovali v termináli, zaškrtnite, čo sa má kopírovať do vašich pracovných priestorov.
- SSH kľúče a tokeny git platforiem.
- Kubeconfig, profily AWS, prístupové údaje pre Google Cloud a Azure a ľubovoľný súbor vo vašom domovskom adresári.
- Pomenované premenné prostredia pre vaše vlastné nástroje.
Všetko, čo synchronizujete, je dostupné agentom v daných pracovných priestoroch. Ak agent nájde prístupový údaj odhalený v repozitári, zaznamená ho v Agents → leaks, aby ste ho mohli vymeniť. Uloží sa iba druh a umiestnenie, nikdy samotné tajomstvo.
Aplikácie
- Prehliadač: všetko funguje v ľubovoľnom modernom prehliadači, na počítači aj na tabletoch.
- iOS: Live Activity so stavmi vašich agentov, widgety na ploche a zamknutej obrazovke, push notifikácie, odpovede jedným ťuknutím a diktovanie.
- macOS, Windows a Linux: desktopová aplikácia s notifikáciami. Na macOS aj widgety na plochu pre agentov, využitie a rozhodnutia.
- Android: aplikácia s celým kokpitom, inštalovaná z odkazu na stiahnutie, ktorý vám pošleme.
Tímy a organizácie
- Jednotné prihlásenie: vaša organizácia prihlasuje svojich ľudí cez vlastného OIDC poskytovateľa identít alebo lokálnymi heslami.
- Správcovia organizácie spravujú jej účty, poskytovateľa identít a auditný záznam.
- Zdieľajte pracovný priestor s kolegami: každý, kto k nemu má prístup, pracuje ako plnohodnotný spolupracovník a vidí jeho rozhodnutia.
- Limity a kvóty: správcovia môžu obmedziť počet pracovných priestorov, pamäť a disk každého účtu.
- Runnery: prevádzkujte pracovné priestory svojej organizácie na vlastnom serveri s Dockerom a Kata. Runner sa pripája smerom von k sinep.dev; váš kód a dáta zostávajú na vašom hardvéri.
- Aktivita: každý vidí iba vlastný prehľad dokončenej práce. Žiadne rebríčky a žiadne počítanie hodín.
Bezpečnostný model
sinep.dev predpokladá, že kód, ktorý agenti spúšťajú, môže byť škodlivý: balíčky a build skripty, ktoré nikto nečítal. Návrh systému drží tento kód vo vnútri jeho pracovného priestoru.
- Jedna microVM na pracovný priestor s vlastným jadrom, ktorá pripája iba tento pracovný priestor.
- Prístup agentov na internet, pričom hostiteľský server, interné služby, privátne a link-local rozsahy, cloudové metadáta a ostatné pracovné priestory sú zablokované.
- Git operácie spustené tlačidlami bežia na serveri s vypnutými hookmi a rizikovou konfiguráciou.
- Kľúče poskytovateľov modelov a chatové relácie zostávajú na serveri. Žiadny nástroj ich agentovi neposkytne.
- Pracovný priestor, chat či súbor iného používateľa sa jednoducho nenájde – nie je len zakázaný.
- Správcovia vidia účty a limity, nikdy obsah pracovných priestorov.
Hostovaný sinep.dev beží v dátových centrách v Európskej únii. Ak potrebujete vyplniť bezpečnostný dotazník alebo chcete podrobnosti, napíšte na contact@sinep.dev.
Pomoc
Používate sinep.dev a neviete si rady? Napíšte na support@sinep.dev. Pre cenovú ponuku, skúšobnú verziu pre váš tím alebo runner na vlastnom hardvéri použite kontaktný formulár alebo napíšte na contact@sinep.dev.