Brain — paměť agenta

Brain je pojmenovaná sada soukromých Markdown souborů, které váš AI agent čte a zapisuje přes MCP — jeho dlouhodobá paměť. Skilly říkají, jak pracovat; Brain říká, co platí ve vašem kontextu: technologie, zvyklosti, zákazníci, už přijatá rozhodnutí.

Všechno můžete mít v jednom Brainu, nebo ho rozdělit podle oblastí — Osobní, Tým, Klient X. První Brain se vytvoří automaticky; další přidáte jedním kliknutím na /brain. Brain můžete sdílet s dalšími lidmi, takže jedna udržovaná paměť slouží agentům celého týmu.

Soubory a verze

Brain obsahuje soubory .md (každý až 2 MB) uspořádané do složek. Pište je ve webovém editoru, nahrajte je, nebo je nechte psát agenta. Každý nový účet začíná třemi soubory, které se dál používají: about-me.md (kdo jste a jak s vámi má agent pracovat), projects.md (přehled vašich projektů a osnova, kterou se řídí soubor každého projektu) a decisions.md (datovaný záznam toho, co a proč se rozhodlo), vzájemně propojenými přes [[wikilinks]]. Pro každý soubor platí dvě věci:

1. Každé uložení vytvoří verzi. Ať ukládá člověk, nebo agent, ať přepisuje, nebo připisuje — předchozí obsah zůstane zachován, takže přepsáním se nikdy nic neztratí.
2. Kontext zůstává úsporný. Malé soubory se načítají celé, ve velkých se vyhledává podle potřeby. U hostovaného agenta přepínačem V kontextu určíte, které soubory dostane při každém běhu.

Pohled agenta (MCP)

Čtyři nástroje, dostupné po jednorázovém přihlášení (OAuth v prohlížeči, nebo MCP token pro klienty bez prohlížeče — viz Připojení ke Claude). Fungují napříč všemi Brainy, ke kterým máte přístup; volitelný argument brain je omezí na jeden:

brain_list(brain?, folder?)            → všechny soubory, které můžete číst, včetně Brainu a vaší role
brain_search(query, brain?)            → soubory a odpovídající řádky, aby agent mohl vybrat, než začne číst
brain_get(name, brain?)                → obsah jednoho Markdown souboru
brain_write(name, body, mode?, brain?) → vytvořit / přepsat / připsat — s verzemi; ve sdílených Brainech vyžaduje roli editora
brain_create(name)                     → nový vlastní Brain, třeba pro projekt nebo klienta

# Brain sdílený s vámi se označuje jménem vlastníka:
brain_get(name: "onboarding.md", brain: "jan/Team")

V praxi prostě mluvíte: z věty „zapamatuj si, že staging se nasazuje z větve release“ se stane brain_write, z otázky „co víme o platební bráně?“ zase brain_search. Zápisy bez uvedeného Brainu skončí ve vašem výchozím Brainu.

Sdílení Brainu

Na kartě Sdílení pozvěte člověka e-mailem a vyberte mu roli: čtenář čte, editor čte i zapisuje. Pozvaný otevře odkaz, přihlásí se přes Google nebo GitHub — účet se mu v případě potřeby rovnou založí — a Brain se mu objeví vedle jeho vlastních, na webu i v MCP jako vase-jmeno/nazev-brainu. Odkaz platí 14 dní; členem se stane ten, kdo ho otevře, proto ho pošlete na správnou adresu.

1. Nastavení u každého souboru. Ve výchozím stavu se sdílí celý Brain, ale každý soubor má přepínač Sdíleno / Jen vy — soubor, který si necháte pro sebe, členové nikdy neuvidí.
2. Role platí všude. Čtenáři se brain_write odmítne na webu i přes MCP; mazání souborů, správa členů a přepínač sdílení u souborů zůstávají jen vlastníkovi.
3. Vše jde vrátit. Členové mohou Brain kdykoli opustit a vlastník může kdykoli odebrat členy nebo zrušit nevyřízené pozvánky.

Soukromí a bezpečnost

Soubory v Brainu se nikdy neobjeví ve veřejném katalogu ani ve vyhledávačích. Jejich obsah — včetně všech verzí — je uložen šifrovaně. A protože Brain je paměť, ne trezor, kontrolujeme každé uložení: obsah, který vypadá jako přístupové údaje (API klíče, tokeny, privátní klíče), odmítneme a odkážeme vás do konfigurace agenta, kam tajné údaje skutečně patří.

Časté dotazy