Skip to content
{ brainjar }

Getting Started

Install

Section titled “Install”
Terminal window
bun install -g @brainjar/cli

Or with npm:

Terminal window
npm install -g @brainjar/cli

Initialize

Section titled “Initialize”
Terminal window
brainjar init --default

This creates your config, downloads the brainjar server, starts it, and seeds starter content:

  • Soul: craftsman — direct, rigorous, craft-oriented voice
  • Personas: engineer (activated), planner, reviewer — three workflows out of the box
  • Rules: boundaries, context-recovery, task-completion, git-discipline, security

It also syncs everything into your CLAUDE.md (or AGENTS.md for Codex).

Verify

Section titled “Verify”
Terminal window
brainjar status
soul     craftsman
persona  engineer
rules    boundaries, context-recovery, task-completion, git-discipline, security

Your first switch

Section titled “Your first switch”

Try changing the persona for a different workflow:

Terminal window
brainjar persona use reviewer
brainjar status --sync

Now your agent behaves as a code reviewer instead of an engineer — same soul, same rules, different workflow.

What happened

Section titled “What happened”

brainjar fetched your active layers from the server, merged them, and inlined them into your agent’s config file between <!-- brainjar:start --> / <!-- brainjar:end --> markers. Everything outside the markers is yours.

Next steps

Section titled “Next steps”