brainkit

An augmentation kit for your brain.

An opinionated second brain implementation, powered by pi (and your own model of choice).

        _---~~(~~-_.
      _{        )   )
    ,   ) -~~- ( ,-' )_
   (  `-,_..`., )-- '_,)
  ( ` _)  (  -~( -_ `,  }
  (_-  _  ~_-~~~~`,  ,' )
    `~ -^(    __;-,((()))
          ~~~~ {_ -_(())
                 `\  }
                   { }

Install

Requires pi installed and configured with an LLM provider.

pi install git:github.com/oribarilan/brainkit

Or try it without installing:

pi -e git:github.com/oribarilan/brainkit

Update anytime with pi update. Brainkit tells you when a new version is available.

With any agent (experimental)

Works with Claude Code, Copilot, OpenCode, Codex, and more. Same vault and skills, without pi-specific extras.

Note: CLI mode is in early development. The core experience should works, but for the full and tested behavior you should use the pi agent.

npx @oribish/brainkit

What is this?

A "second brain" is a system for capturing and organizing everything you know (accomplishments, people, meeting notes, projects, ideas) so you can find it when you need it instead of keeping it all in your head.

Brainkit is an opinionated agentic implementation of that idea. It's a structured markdown vault that follows the PARA method, uses a bragfile, contacts.md and more. Delivered with an AI agent that actually understands it. You talk, things happen:

• "I just shipped the API redesign" → adds it to your bragfile, in the right section
• "I had a meeting with Sarah about the migration" → creates meeting notes, cross-references Sarah from contacts, files it under the right project
• "Who was that engineer from the platform team?" → searches your contacts

No commands, no formatting, no manual filing. The agent handles it.

Getting Started

pi

Type /setup and the agent walks you through a getting-to-know-you conversation — your work, your personal life, your preferences. It creates a vault that matches your actual life, not an empty template.

Features

PARA vault

Everything goes into four directories:

• 01_projects/ — active efforts with a deadline (work and personal)
• 02_areas/ — ongoing responsibilities (career, health, finances)
• 03_resources/ — reference material and interests
• 04_archive/ — done or no longer relevant

Bragfile

A log of professional accomplishments at 02_areas/career/bragfile.md. The agent recognizes accomplishments in conversation and offers to capture them. Entries are placed programmatically. Nudges you if it's been more than two weeks since your last brag log.

Contacts

A people index at 03_resources/contacts.md: colleagues, family, doctors, anyone. The agent cross-references people when they come up in conversation and suggests adding new ones.

Meeting notes

Structured notes from any meeting: work, doctor visits, school conferences. Filed under the relevant PARA directory, named YYYY-MM-DD-topic.md, with attendees, decisions, and action items.

Vault health

/doctor fixes issues automatically: missing directories, naming violations, orphaned files. Checks that your GitHub repo is private. Detects stale projects that might need archiving. Never deletes, always archives.

Auto-commit

Vault changes are git-committed automatically after conversations. Debounced so rapid changes collapse into one commit. Skips silently if not a git repo.

Bundled Extensions

Pi comes pretty basic, but it is composable. Extensions can be mixed and matched to build your ideal workflow. You can even run Doom inside it. Brainkit ships with a curated set of companion extensions from the pi ecosystem:

• Plan mode — toggleable read-only exploration mode (/plan or Ctrl+Alt+P). The agent can search and read but can't modify anything, useful for understanding before changing.
• Permission gate — prompts for confirmation before running potentially dangerous bash commands (rm -rf, sudo, chmod 777).
• Questionnaire — structured tool for asking the user single or multiple-choice questions with a tab-based UI, used by the agent to clarify requirements and preferences.

These are loaded automatically when you install brainkit. No extra setup needed.

Adding more extensions

Pi extensions are composable. You can add any pi extension alongside brainkit:

pi install git:github.com/someone/cool-extension

Or drop a .ts file into ~/.pi/agent/extensions/ for local extensions. See the pi extension docs for details.

License

MIT