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.
- Připojte svou git platformu v Settings → git integrations, nebo přidejte SSH klíč v Settings.
- Vytvořte workspace z repozitáře. Jeho virtuální stroj se spustí během několika sekund.
- Přihlaste CLI agentů ke svým účtům v Settings → agents a pak ve workspacu spusťte agenta.
- 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.