sinep.dev

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.

  1. Pripojte svoju git platformu v Settings → git integrations alebo pridajte SSH kľúč v Settings.
  2. Vytvorte pracovný priestor z repozitára. Jeho virtuálny stroj sa spustí za pár sekúnd.
  3. Prihláste CLI nástroje agentov do svojich účtov v Settings → agents a potom spustite agenta v pracovnom priestore.
  4. 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.