Recipes

Code review session

Save a review brain once, activate it anytime:

# Set up the configuration
brainjar soul use craftsman
brainjar persona use reviewer
brainjar rules add boundaries
brainjar rules add security
brainjar brain save review

# Activate anytime
brainjar brain use review

# Or scope to a single session
brainjar shell --brain review

CI pipeline — enforce rules without a persona

Use environment variables in CI to override behavior:

BRAINJAR_PERSONA=auditor \
BRAINJAR_RULES_ADD=security,compliance \
brainjar status --sync

Project-specific persona

Override behavior for a specific project without affecting your global config. Project scope is auto-detected from the .brainjar/ directory:

cd my-project
brainjar persona use planner
brainjar rules add no-delete

brainjar status
# soul     craftsman (workspace)
# persona  planner (project)
# rules    boundaries (workspace), no-delete (+project)

Scoped shell sessions

Temporarily switch context without changing any state files:

brainjar shell --persona reviewer --rules-add security
# Inside this shell, BRAINJAR_* env vars are set
# Exit the shell and everything reverts

Team sharing with packs

Export your setup and share it with teammates:

# You
brainjar pack export review --author frank --version 1.0.0

# Teammate
brainjar pack import ./review --activate

MCP server registration

Register brainjar as an MCP server so agents can discover and use all commands:

brainjar mcp add                         # Global, auto-detect agent
brainjar mcp add --agent cursor          # Target a specific agent
brainjar mcp add --no-global             # Project-local only

Skill files

Sync brainjar skill files to your agent for slash-command integration:

brainjar skills add                      # Global install
brainjar skills add --no-global          # Project-local only

Shell completions

Set up tab completion for brainjar commands:

eval "$(brainjar completions zsh)"       # Add to ~/.zshrc
eval "$(brainjar completions bash)"      # Add to ~/.bashrc

Multiple backends

Work with both Claude Code and Codex:

brainjar init --backend claude    # Default
brainjar init --backend codex     # Also set up Codex