Getting Started

Get up and running with GitBrain in minutes.

Install GitBrain

GitBrain ships as a standalone binary. Install with a single command:

$ curl -fsSL https://gitbrain.cc/install.sh | sh

Wire Your Machine

One command, every time. setup finds the brains already on this machine, registers them, installs the skills your AI client reads, and writes the rules file:

gitbrain setup ~/brains
gitbrain status

The path is where your brain folders live. Leave it off and GitBrain looks in ~/tetronomis/brains, then the current directory.

Run setup again whenever anything changes — a new brain, a new machine, a new version. It is safe to repeat and it never overwrites a file you edited by hand. To see what it would do without writing anything, add --check.

No Brain Yet?

init scaffolds an empty brain folder. It does not register it — setup does that, so registration happens in one place:

gitbrain init ~/brain
gitbrain setup ~/brain

Add Your First Note

A section is just a folder in your brain. Make one, then write to it:

mkdir ~/brain/ideas
gitbrain add "Today I learned about Next.js App Router" --section ideas

Connect GitNotes

Download GitNotes and open it. It reads your ~/.gitbrain/config.yml automatically and shows all configured brains.

Team Setup

Want to set up GitBrain for your team? We help organizations deploy on their own infrastructure.