Data ve vlastním repozitáři
Co to je
Brain normálně hostuje onlybrain: soubory i celá historie jsou v onlybrainu na šifrovaném disku. Firma, která chce mít data u sebe, připojí vlastní git repozitář.
- Repozitář je zdroj pravdy. Jsou v něm všechny soubory a celá historie brainu.
- onlybrain do něj zapisuje. Každá změna z aplikace, z Claude Code, z Codexu nebo z konektoru onlybrain pushne do repozitáře.
- Změny z repozitáře onlybrain převezme. Co někdo pushne přímo do repozitáře, se v onlybrainu objeví.
- Pro lidi se nic nemění. Role, sdílení, hledání, aplikace onlybrain i konektor fungují stejně jako u hostovaného brainu.
Podporované služby: GitHub, GitLab (gitlab.com i vlastní server) a jiný git přes HTTPS (Gitea, Bitbucket, Azure DevOps).
Připojit repozitář
Připojuje správce brainu v Nastavení v sekci Kde jsou data tlačítkem Připojit vlastní repozitář. Nový brain rovnou z repozitáře jde vytvořit na stránce Nahrát vlastní brain, volba Napojit git repozitář. Typ brainu se nevybírá, navrhne ho AI (viz níže).
Napojit git repozitář je trvalé napojení: data zůstanou v repozitáři a onlybrain s ním zůstane propojený, dokud se v Nastavení → Kde jsou data neodpojí. Volba Nahrát ze souboru je naopak jednorázová kopie, kterou pak hostuje onlybrain.
- Služba. Zvolit GitHub, GitLab nebo jiný git.
- Adresa a klíč. Vložit HTTPS adresu repozitáře (tlačítko Code nebo Clone) a přístupový klíč (token) s právy jen k tomuto repozitáři:
- GitHub: fine-grained token na github.com/settings/personal-access-tokens/new. Repository access: Only select repositories, jen tento repozitář. Permissions: Contents - Read and write (Metadata read přidá GitHub sám).
- GitLab: project access token v projektu v Settings → Access tokens. Role Maintainer (Developer nesmí pushovat do chráněné větve main), scopes read_repository a write_repository.
- Gitea: Settings → Applications, token s oprávněním repository Read and write.
- Bitbucket: repository access token se scope Repositories: Write, uživatelské jméno
x-token-auth. - Azure DevOps: personal access token se scope Code: Read & write, uživatelské jméno libovolné.
- Kontrola. onlybrain ověří adresu, čtení, zápis, výchozí větev a historii a ukáže výsledek každého kroku. Po kliknutí na Připojit se celá historie brainu nahraje do repozitáře. Repozitář proto musí být prázdný, nebo už obsahovat stejnou historii.
- Co onlybrain zapíše. Pod kontrolou je seznam souborů, které onlybrain do repozitáře zapíše. Pokračovat jde až po zaškrtnutí Rozumím, onlybrain do repozitáře zapíše tyto soubory.
Klíč se uloží jen v onlybrainu, šifrovaně. V prohlížeči nezůstane. Vyměnit ho jde kdykoli tlačítkem Změnit přístupový klíč, třeba když vyprší.
Co onlybrain do repozitáře zapíše
Při připojení i při vytvoření brainu z repozitáře onlybrain doplní, co potřebuje pro role a pro AI nástroje. Přesný seznam pro konkrétní repozitář ukáže průvodce před potvrzením.
.onlybrain/: role (roles.yml, jen když v repozitáři ještě nejsou), popis brainu pro onlybrain (manifest.json) a nastavení onlybrainu.AGENTS.md: instrukce pro AI nástroje.- Soubory pro Claude Code a Codex:
CLAUDE.md,.claude/a.agents/s odkazy na skills a agenty, bez symlinků. README.md: jen u prázdného repozitáře.
Soubory přijdou jako nové commity přímo do hlavní větve, bez pull requestu. Když je hlavní větev chráněná a přístupový klíč do ní nesmí zapisovat, připojení se zastaví. Pak je potřeba klíči zápis do hlavní větve povolit (u GitLabu role Maintainer).
Návrh struktury s AI
Po vytvoření brainu z repozitáře (i po nahrání ze souboru) nabídne onlybrain Navrhnout strukturu s AI. AI projde obsah repozitáře (strom složek, README, AGENTS.md a CLAUDE.md, ukázky dokumentů, ne celý obsah) a navrhne typ brainu, role, AGENTS.md, agenty a skills, které k obsahu sedí. Když repozitář ještě nemá AGENTS.md, návrh se spustí sám.
Návrh přijde jako změna ke schválení ve Změnách. Dokud ho správce neschválí, v brainu ani v repozitáři se nic nezmění. Schválit jde celý návrh nebo jen některé soubory.
Webhook
Bez webhooku onlybrain stahuje změny z repozitáře pravidelně, každých pár minut (přesný interval je vidět v nastavení). S webhookem jsou změny v onlybrainu hned. Adresa a tajný klíč webhooku jsou v Nastavení → Kde jsou data → Webhook, každý s tlačítkem pro kopírování.
- GitHub: v repozitáři Settings → Webhooks → Add webhook. Payload URL: adresa webhooku, Content type:
application/json, Secret: tajný klíč, Which events: Just the push event. - GitLab: v projektu Settings → Webhooks → Add new webhook. URL: adresa webhooku, Secret token: tajný klíč, Trigger: Push events.
- Gitea a Bitbucket: webhook na událost push se stejnou adresou a tajným klíčem.
- Azure DevOps a ostatní: nic nastavovat není potřeba, změny se stahují pravidelně.
Tlačítko Vygenerovat nový tajný klíč starý klíč hned zneplatní. Nový je pak potřeba vložit i do webhooku v repozitáři.
Co je kde
- V repozitáři firmy: všechny soubory a celá historie. Repozitář je zdroj pravdy.
- V onlybrainu: pracovní kopie pro role, hledání a konektor, na šifrovaném disku.
- U poskytovatelů AI: obsah jimi prochází, když lidé pracují s Claude nebo Codexem, stejně jako u hostovaného brainu.
Odpojit brain vrátí do onlybrainu: zůstane v něm se všemi soubory a historií a dál ho hostuje onlybrain. Repozitář zůstane beze změny, onlybrain do něj přestane zapisovat a přístupový klíč se smaže. Kopie v onlybrainu se smaže až se smazáním brainu, repozitář i potom zůstane.
Push přímo do repozitáře
Do repozitáře jde pushovat i bez onlybrainu, třeba z vlastního počítače nebo z CI. Změna se v onlybrainu objeví po webhooku, bez webhooku do několika minut.
- Role platí dál. Kdo pracuje přes onlybrain, vidí a mění jen to, co dovolí jeho role, i u souborů, které přišly přímo z repozitáře.
- Přímý přístup k repozitáři je mimo role. Kdo má práva přímo v GitHubu nebo GitLabu, vidí celý repozitář. Přístup k repozitáři proto patří jen lidem, kteří mají vidět všechno.
- Výchozí větev. onlybrain pracuje s výchozí větví repozitáře (obvykle
main), ta je vidět v nastavení.