@partofthenarrative/brain

Install and manage your AI Second Brain — a personalized Claude Code workspace for event professionals.

Prerequisites

1. Node.js 18+ — Download from nodejs.org (LTS recommended)
2. Claude Pro subscription — Sign up at claude.ai
3. GitHub account — github.com

Install

npx @partofthenarrative/brain init

The wizard walks you through setup in ~10 minutes:

• License validation
• Your name, email, company, role
• GitHub repo creation
• Voice guide setup (paste 3 emails you're proud of)
• First project scaffolding

Everything else — skills, hooks, memory structure, onboarding guide — is installed automatically.

The install path must be under your home directory or another writable location. System directories (/etc, /usr, /System, …) and sensitive home subpaths (~/.ssh, ~/.aws, ~/Library, …) are rejected.

Commands

| Command | Description | |---------|-------------| | brain init | Set up a new brain | | brain add <bundle> | Add an integration (gmail, outlook, notion, krisp) | | brain update | Update skills and hooks to latest versions | | brain list | Show installed skills and available bundles |

After install

Open FIRST-STEPS.md in your new brain for the full onboarding walkthrough.

Privacy & telemetry

On each init, add, and update we POST a small event to our Supabase backend so we know who installed and can debug issues. The payload:

• your license key (so we can match it to you)
• CLI version, OS (darwin / linux / win32)
• which event ran (init / add / update)
• for init: whether you created a first project and whether the deep-research sub-agent was installed
• for add: which bundle

No file contents, no emails, no names. Opt out with either:

brain init --no-telemetry
# or
BRAIN_NO_TELEMETRY=1 brain init

Your voice-guide emails, project notes, and everything else in your brain live only in the private GitHub repo that init creates. We never see them. Keep that repo private.

Full security notes: see SECURITY-AUDIT-2026-04-21.md. Release-by-release changes: see CHANGELOG.md.

License

Proprietary — requires a valid license key from Narrative.