5-minute install · No infrastructure

From download to first task
in under 5 minutes.

Brainfile is a config bundle for Claude Code. You run it inside your own Claude Code subscription — no extra API keys, no databases, no servers. Drop it in, restart Claude, go.

Install Brainfile

1

Install Claude Code

Brainfile runs inside Anthropic's Claude Code CLI. If you don't have it yet, install it first — it's free to download (you'll need a Claude Pro or API account to use it).

npm install -g @anthropic-ai/claude-code

Full install instructions and platform-specific options (macOS, Linux, Windows): docs.claude.com/claude-code.

Already have Claude Code? Skip to step 2.
2

Download your Brainfile package

Each persona pack contains a CLAUDE.md + a .claude/ directory tuned for one role. Pick the one closest to your work — you can mix rules from others later, every file is plain markdown.

Pro tip: if your role isn't listed, start with Founder or Consultant — both are designed to flex across business functions.
3

Drop CLAUDE.md and .claude/ into your project root

Open a terminal, go to the project where you want Claude Code to use this OS, and unzip the package there:

cd ~/your-project && unzip ~/Downloads/brainfile-developer.zip

You should now see CLAUDE.md, .claude/, and a memory/ folder at the root of your project. Replace brainfile-developer.zip with whichever persona you downloaded.

Already have a CLAUDE.md? Don't overwrite it — see the FAQ below for the safe merge pattern.
4

Restart Claude Code & verify

Quit any running Claude Code session in this directory and start a fresh one:

claude

Claude automatically loads CLAUDE.md + the rules in .claude/rules/ on the first message. To confirm everything's wired up, run:

/agents

You should see your role-specific agents (or rules, depending on your persona pack) listed. If /agents returns nothing custom, double-check that CLAUDE.md is in the same folder you launched claude from.

5

Try a sample task

Ask Claude to read its new context and tell you what it knows. This is the fastest way to confirm the install worked end-to-end:

Read my Brainfile (CLAUDE.md + .claude/rules/) and summarize: what role am I, what rules are loaded, and what should you do differently in this project compared to a fresh Claude Code session?

You should get a role-aware response that references the rules from your persona pack — not a generic summary. That's your signal that Brainfile is live.

15 personas. Drop-in markdown. Zero dependencies.

Every persona pack is a small ZIP (~30-40 KB) with three things: a tuned CLAUDE.md, a .claude/rules/ directory, and a memory/ starter. No binaries, no scripts you have to trust — open every file, read every line.

Personas
15 role-specific packs
Developer, Founder, Trader, Marketer, PM, Data Sci, Designer, DevOps, Exec, Content Creator, Consultant, Agency Owner, Researcher, Lawyer, Real Estate Investor
CLAUDE.md
1 per persona, tuned
Role identity, communication preferences, decision frameworks, project conventions
Rules
2-3 per persona
Loaded automatically by Claude Code from .claude/rules/
Memory starter
MEMORY.md + user_profile.md
Templates that grow as you work — Claude updates them as your context changes
Format
100% plain markdown
Edit anything. Mix files between personas. Version with git.
Compute
Runs on your Claude plan
No additional API keys. No Anthropic API charges from us. Zero infrastructure.

Quick answers

Brainfile is built specifically for Claude Code. The .claude/rules/ directory and Claude Code's auto-loading of CLAUDE.md are the mechanisms it relies on. Cursor uses .cursorrules, Windsurf uses .windsurfrules — different formats. The CLAUDE.md content itself is portable plain markdown you can adapt, but the agents/rules wiring is Claude Code only. We focus exclusively on Claude Code so every file leverages its full feature set instead of being a lowest-common-denominator template.
Don't blindly overwrite it. Two safe paths: (1) rename your existing one to CLAUDE.local.md, install Brainfile, then merge any project-specific rules back into the new CLAUDE.md; or (2) install Brainfile in a fresh sub-folder, diff the two CLAUDE.md files, and pull the sections you want. Every Brainfile file is plain markdown — there's no magic, just structured prose. Take what's useful, discard what isn't.
No. Brainfile runs inside your own Claude Code subscription. If you're already using Claude Code (with a Claude Pro/Max plan or your own API key), Brainfile just adds context — it doesn't make any API calls itself. We never see your prompts or responses. Your compute, your bill, your data.
Yes, edit freely — every file is plain markdown you own. We don't push updates that overwrite anything. When we ship a new version, it's a new ZIP you choose to download. Treat your installed Brainfile as your config, version it in git, and pull updates manually when you want them.
Yes. The cleanest pattern: install your primary persona first, then copy individual rules from other personas into .claude/rules/. For example, a founder who also does marketing can pull .claude/rules/ files from brainfile-marketer.zip alongside the founder pack. Claude Code loads every file in .claude/rules/ at session start.
Three things to check: (1) CLAUDE.md must be in the same directory you launched claude from (project root, not a sub-folder); (2) you may need to fully quit and relaunch Claude Code, not just start a new chat; (3) confirm .claude/rules/ exists and has files in it (ls .claude/rules/). If all three check out and Claude is still generic, email [email protected] with your terminal output.

Ready to install?

Pick your persona, drop it in, restart Claude Code. 30-day money-back guarantee on every paid plan.

See pricing & pick your persona → Try the free builder