Krok 8

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.

  1. Služba. Zvolit GitHub, GitLab nebo jiný git.
  2. 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é.
  3. 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.
  4. 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í.