braynee Documentation
braynee is a simple Claude Code plugin — an ambient hook engine plus an Obsidian-backed second brain. Skills, hooks, agents, and the session → recall → beads workflow.
braynee is a simple tool. It does two things, and that's the whole product.
- It fires Claude Code lifecycle hooks in the background and manages your Claude Code settings for you.
- It turns an Obsidian PARA vault into long-term memory and feeds the right slice of that memory into Claude Code for whatever you're working on.
That's it. Everything else in these docs is detail on those two pillars.
Pillar 1 — The Engine
Claude Code emits events: a session starts, you submit a prompt, a tool runs, the session ends. braynee registers hooks on those events and they run ambiently — you never invoke them. The same engine reads and edits your Claude Code settings so you don't have to hand-edit JSON.
Mechanically it's simple: events in, scripts fire, context and settings get managed for you.
Pillar 2 — Your Second Brain
The other half is memory. braynee organizes an Obsidian PARA vault — Projects, Areas, Resources, Archives — and uses it as durable, searchable memory. When you start working on something, the engine pulls the relevant slice of that vault into the session: the project you're building, the client you're emailing, the goals you set, the decision you made three sessions ago.
The domains you actually care about — clients, business, email, projects, goals — all map onto PARA. braynee's job is keeping that memory current and putting the right piece of it in front of Claude Code at the right time.
This documentation is ground-truth
The Skills, Hooks, and Agents references are generated directly from the installed braynee plugin, so they always match the exact version you're running.
Start here
Quickstart
Install, run setup, restart — the quickest way in.
Getting Started
The fuller install path, prerequisites, and what happens next.
PARA — What braynee manages
The vault structure that becomes your second brain.
The Workflow
The session → recall → beads loop, in practice.