Install kluris. Create a brain.

A brain is a git repo of curated markdown that every AI agent on your team reads as a subject matter expert. One command to install. One wizard to create your first one.

$ brew install pipx
$ pipx ensurepath
$ pipx install kluris

$ python3 -m pip install --user pipx
$ pipx ensurepath
$ pipx install kluris

> pip install pipx
> pipx ensurepath
> pipx install kluris

$ kluris create

Brain name: acme-brain
Brain type:
  [1] project-group  [2] personal
  [3] product        [4] research
  [5] blank
Choice: 1
Location: ~/Projects/acme-brain
Initialize git? y

  ✓ Created acme-brain
  ✓ Git initialized on main
  ✓ Registered acme-brain
  ✓ Installed /kluris skill for 8 agents

Next: open any project in your AI agent and
      type /kluris learn this service

acme-brain/
├── kluris.yml              # gitignored — your local config
├── brain.md                # root directory, auto-generated
├── glossary.md             # domain terms, hand-edited
├── README.md               # usage guide
├── .gitignore
├── projects/
│   └── (your neurons go here)
├── infrastructure/
│   └── (your neurons go here)
└── knowledge/
    └── (your neurons go here)

Every brain is a git repo. Your knowledge is markdown. Nothing is magic.

See the whole brain.

One command. A local, interactive map you can share.

$ kluris mri

MRI complete — brain-mri.html
  51 neurons, 491 synapses
  → file:///.../brain-mri.html

Open it in any browser. Commit it, email it,
drop it in Slack — it runs anywhere, no server.

Live counts (51 neurons · 491 synapses), a lobe breakdown you can collapse and filter, and a fuzzy search across names, paths, lobes, and tags. Click a lobe to isolate it; click a node to open it.

One click on any node opens its neuron, fully rendered, with the related-neuron tabs across the top so you can walk a topic in seconds. This is what agents see — now visible to you.

Lines between neurons are synapses — cross-links agents follow to load related context. A pre-digested brain means agents spend far fewer tokens orienting to a codebase than without one.

Your brain grows with your team.

Add lobes, add neurons, keep going — all through the agent.

> /kluris add a compliance lobe for SOC2
         and GDPR notes

Proposing new lobe: compliance/
  ✓ will create compliance/map.md
  ✓ will link into brain.md

[a]pprove  [c]ancel: 

> /kluris remember that SOC2 audit evidence
         lives in the compliance-evidence/ bucket,
         rotated yearly

Proposing: compliance/soc2-evidence.md
──────────────────────────────────────
# SOC2 audit evidence

Evidence artifacts live in the
`compliance-evidence/` S3 bucket. Rotation is
annual. Access is restricted to the security team.
──────────────────────────────────────

[a]pprove  [e]dit  [s]kip: 

Lobes are folders, neurons are markdown files inside them — but you don't create them by hand. Ask the agent. It proposes the structure, shows you the diff, and writes it only after you approve. Nesting works the same way: "add a sublobe for the endpoints of acme-api" and the agent puts it in the right place.

Run kluris dream to regenerate maps after structural changes. Run kluris push to commit and share with your team. Have more than one brain? Each installs as /kluris-<name> and everything above works the same.

Your AI agents, finally on your team.

Kluris is a tiny idea that compounds: a git repo becomes a brain, a brain becomes a subject matter expert, and that expert shows up in every agent on every laptop every morning — grounded in what your team actually knows.

$ pipx install kluris
$ kluris create                         # new brain from scratch
  # — or — 
$ kluris clone git@github.com:team/brain.git   # join a team brain
$ kluris register ~/path/to/brain            # adopt a brain already on disk
→ agent skills auto-install · open any repo · type /kluris in chat