sinep.dev

DOKUMENTACE

Jak sinep.dev funguje

Prohlídka všech částí sinep.dev: co dělají, jak je používat a na co pamatovat.

Začínáme

sinep.dev je dostupný na pozvání. Jakmile máte účet, přihlaste se na sinep.dev přes jednotné přihlášení vaší firmy nebo e-mailem a heslem, které jste dostali.

  1. Připojte svou git platformu v Settings → git integrations, nebo přidejte SSH klíč v Settings.
  2. Vytvořte workspace z repozitáře. Jeho virtuální stroj se spustí během několika sekund.
  3. Přihlaste CLI agentů ke svým účtům v Settings → agents a pak ve workspacu spusťte agenta.
  4. Pokud chcete notifikace a widgety, nainstalujte si aplikaci pro iOS nebo desktop.

Workspacy

Workspace je jeden projekt s vlastním virtuálním strojem: Kata microVM s vlastním jádrem, kompletní linuxovou výbavou a připojenými soubory pouze tohoto projektu. Agenti v jednom workspacu nevidí jiný workspace, jiného uživatele ani hostitelský server.

  • Soubory, konverzace agentů i váš domovský adresář přežijí restart virtuálního stroje.
  • Uvnitř je k dispozici rootless podman, takže agenti mohou sestavovat a testovat kontejnerové obrazy. Docker socket tam není.
  • Každý workspace má limity paměti, CPU a procesů a každý účet má diskovou kvótu. Agent zaseknutý ve smyčce zpomalí jen sám sebe.
  • Workspace, který nepoužíváte, můžete zmrazit a uvolnit tak jeho paměť. Soubory zůstanou a agenti, kteří běželi, po rozmrazení pokračují.
  • Tailscale pro jednotlivé workspacy (volitelně) umožní agentům dostat se do firemní sítě přes váš vlastní tailnet, s přístupem řízeným vašimi Tailscale ACL.

Agenti a terminály

Claude Code, Codex a OpenCode běží ve skutečných terminálech uvnitř workspacu. Každý terminál žije v tmux session, takže zavření záložky prohlížeče ani výpadek spojení nic nezastaví.

  • Spusťte tolik agentů, kolik prostředky workspacu dovolí, každého v jeho vlastní záložce.
  • Stránka Agents ukazuje všechny agenty ve všech workspacech: kteří pracují, kteří čekají na vás a kteří jsou hotovi.
  • Instrukce, skilly a MCP servery nastavené v Settings → agents dostanou všichni vaši agenti.
  • MCP server sinep.dev umožňuje agentům otevírat soubory a diffy ve vašem prohlížeči, ptát se vás na rozhodnutí, posílat náhledové odkazy a, pokud to povolíte, číst a psát ve vašich chatech.

Review a git

Vše, co agent změní, se objeví v panelu review, soubor po souboru, se zvýrazněním na úrovni slov.

  • Stagujte celý soubor, jeden hunk nebo jediný řádek a pak commitněte se zprávou.
  • Push, pull a otevírání pull nebo merge requestů na GitHubu, GitLabu či Forgejo. Tyto operace běží na serveru s vašimi uloženými přístupovými údaji, ne uvnitř workspacu.
  • Checkpointy vám umožní vrátit se ke stavu před tahem agenta.
  • Volné úpravy jsou vždy povolené: žádnou změnu nemusíte provádět přes agenta.

Plány s původem

U větší práce můžete napsat plán a aplikovat ho jako migraci. sinep.dev vytvoří větev, spustí agenta podle plánu, spustí vaše akceptační příkazy a výsledek commitne.

  • Každý commit zaznamenává, který plán, agent, model a session ho vytvořily. Celý přepis se ukládá do git notes, takže i čerstvý klon obsahuje kompletní historii.
  • Plán se nikdy nepřehraje deterministicky. Jeho opětovné spuštění je re-roll: nová větev a nový záznam, nikdy přepsání.
  • Pokud něco selže, větev i pracovní strom zůstanou, abyste je mohli prozkoumat nebo převzít. Cílové větve se nic nedotkne.

Rozhodnutí a poznámky

Agent, který vás potřebuje, se nezastaví a nečeká v terminálu, který nesledujete. Zaznamená rozhodnutí: otázku, kontext a dvě až pět možností se svým doporučením. Pak pokračuje v tom, co na odpovědi nezávisí.

  • Odpovězte ze stránky Agents, z push notifikace nebo ze zamčené obrazovky iOS. Odpověď se agentovi vepíše zpět.
  • Intervence jsou úkoly, které zvládne jen člověk, třeba přihlášení někam nebo přidání DNS záznamu. Označíte je jako hotové a agent to ověří a pokračuje.
  • Poznámky vám sdělí, co agent udělal a o čem byste měli vědět, třeba nasazení, aniž by se na cokoli ptal.
  • Chcete-li nechat rozhodnout někoho bez účtu, sdílejte mu odkaz na jedno rozhodnutí. Uvidí jen tuto otázku.
  • Agenti se přes rozhodnutí nikdy neptají na heslo ani klíč. Tajné údaje patří tam, kam patří, například do Settings → workspace credentials.

Asistent

Asistent je váš vlastní agent ve vlastním workspacu, nastavený v Agents → assistant. Vidí vaše agenty v ostatních workspacech a může do nich psát, což běžní agenti nikdy nemohou.

  • Požádejte ho o spuštění úkolu: spustí agenta na vlastní větvi a ve vlastním checkoutu.
  • Čeká na agenty, kterým zadal práci, a hlásí jejich výsledky, nebo vám dá vědět, když se některý zasekne.
  • Pokud to povolíte, může odpovídat na rozhodnutí v rámci pravidel, která jste sepsali. Každou odpověď přesto uvidíte.
  • Zprávy z chatů nebo od jiných agentů k němu dorazí označené jako data. Jedná jen podle vašich slov a vašich pravidel.

Úlohy

Úloha je zpráva, kterou jste napsali a která se vepíše asistentovi, všem vašim agentům, agentům jednoho workspacu nebo jednomu agentovi. Spustí se, když se aktivuje některý z jejích spouštěčů.

  • Plán: cron výraz ve vašem časovém pásmu, nejčastěji každých pět minut.
  • Webhook: externí služba zavolá tajnou URL úlohy. Text, který pošle, se přidá jen tehdy, pokud jste to povolili, a je označen jako data zvenčí.
  • Chat: nepřečtená zpráva odpovídá vašemu pravidlu, například přímá zpráva, zmínka, klíčové slovo, odesílatel nebo podmínka popsaná běžnými slovy. Zprávy, které dorazí společně, se doručí v jednom spuštění.
  • Inzyde: událost ve vaší organizaci v Inzyde, například vytvoření nebo dokončení úkolu.

Spouštěč rozhoduje jen o tom, kdy se úloha spustí. Cíl i zpráva jsou vždy vaše a každá úloha má omezeno, jak často se smí spustit.

Chaty

Připojte své chatovací účty v Settings → chats a čtěte je všechny v jedné schránce: Matrix (včetně šifrovaných místností), Slack, Microsoft Teams, Signal, Telegram, WhatsApp Business a Gmail. Ke každé službě můžete připojit více účtů.

  • Agenti umí přes nástroje MCP sinep.dev najít konverzaci, přečíst ji a odpovědět za vás. E-maily se agentům nikdy nepředávají.
  • Návrhy odpovědí: u vybraných konverzací sinep připraví odpověď nebo reakci a čeká na vaše kliknutí.
  • Jednání bez ptaní je samostatný přepínač pro každou konverzaci, s přísnými limity na to, co a jak často smí dělat.
  • Se zprávami se vždy zachází jako se slovy jiných lidí, nikdy jako s instrukcemi.

Náhledové odkazy

Webová aplikace běžící ve workspacu, třeba dev server nebo API, dostane soukromý odkaz z nabídky portů. Agent vám může odkaz poslat i sám.

  • Odkazy platí jednu hodinu a v nabídce portů je můžete kdykoli zrušit.
  • Náhledy se servírují ze samostatné domény, takže kód v náhledu nikdy nemůže jednat vaším jménem na sinep.dev.

Přístupové údaje

Ve výchozím stavu zůstávají přístupové údaje ke gitu na serveru a git operace spouštěné tlačítky běží tam. Pokud chcete, aby git, cloudová CLI nebo jiné nástroje fungovaly v terminálu, zaškrtněte, co se má zkopírovat do vašich workspaců.

  • SSH klíče a tokeny git platforem.
  • Kubeconfig, AWS profily, přístupové údaje ke Google Cloud a Azure a libovolný soubor ve vašem domovském adresáři.
  • Pojmenované proměnné prostředí pro vaše vlastní nástroje.

Cokoli synchronizujete, mají agenti v těchto workspacech k dispozici. Pokud agent najde v repozitáři odhalené přístupové údaje, zaznamená je v Agents → leaks, abyste je mohli změnit. Ukládá se jen druh a umístění, nikdy samotný tajný údaj.

Aplikace

  • Prohlížeč: vše funguje v jakémkoli moderním prohlížeči, na počítači i na tabletu.
  • iOS: Live Activity se stavy vašich agentů, widgety na ploše a na zamčené obrazovce, push notifikace, odpovědi jedním klepnutím a diktování.
  • macOS, Windows a Linux: desktopová aplikace s notifikacemi. Na macOS navíc widgety na plochu pro agenty, využití a rozhodnutí.
  • Android: aplikace s plnohodnotným kokpitem, instalovaná ze souboru, který vám pošleme.

Týmy a organizace

  • Jednotné přihlášení: vaše organizace přihlašuje své lidi přes vlastního OIDC poskytovatele identit, nebo lokálními hesly.
  • Administrátoři organizace spravují její účty, poskytovatele identit a auditní log.
  • Sdílejte workspace s kolegy: každý, kdo k němu má přístup, pracuje jako plnohodnotný spolupracovník a vidí jeho rozhodnutí.
  • Limity a kvóty: administrátoři mohou každému účtu omezit workspacy, paměť a disk.
  • Runnery: provozujte workspacy své organizace na vlastním serveru s Dockerem a Kata. Runner se připojuje směrem ven k sinep.dev; váš kód a data zůstávají na vašem hardwaru.
  • Aktivita: každý vidí jen svůj vlastní záznam dokončené práce. Žádný žebříček, žádné počítání hodin.

Bezpečnostní model

sinep.dev počítá s tím, že kód, který agenti spouštějí, může být škodlivý: balíčky a build skripty, které nikdo nečetl. Návrh systému drží takový kód uvnitř jeho workspacu.

  • Jeden microVM na workspace s vlastním jádrem, který připojuje jen tento workspace.
  • Přístup agentů k internetu, přičemž hostitelský server, interní služby, privátní a link-local rozsahy, cloudová metadata a ostatní workspacy jsou blokované.
  • Git operace spouštěné tlačítky běží na serveru s vypnutými hooky a rizikovou konfigurací.
  • Klíče k poskytovatelům modelů a chatovací relace zůstávají na serveru. Žádný nástroj je agentovi nepředá.
  • Workspace, chat nebo soubor jiného uživatele se prostě nenajde, nikdy není jen zakázaný.
  • Administrátoři vidí účty a limity, nikdy obsah workspaců.

Hostovaný sinep.dev běží v datových centrech v Evropské unii. Kvůli bezpečnostnímu dotazníku nebo podrobnostem pište na contact@sinep.dev.

Podpora

Používáte sinep.dev a zasekli jste se? Napište na support@sinep.dev. Kvůli ceně, zkušebnímu provozu pro váš tým nebo runneru na vlastním hardwaru použijte kontaktní formulář nebo napište na contact@sinep.dev.