U Skills & Agents
← All Agents
Productivity v1.0.0 By gnekt

My Brain Is Full: Crew

My Brain Is Full Crew is a third-party, open-source system (MIT, by gnekt) that turns an Obsidian vault into a chat-driven knowledge base. It ships 8 agents and around 14 skills: Architect (vault structure and setup), Scribe (capture and clean text), Sorter (inbox triage and filing), Seeker (search and synthesis), Connector (knowledge-graph links), Librarian (vault health and weekly review), Transcriber (audio and meeting notes), and Postman (email and calendar). A dispatcher routes each message to the right agent or skill based on intent, so you work by talking rather than managing files by hand. It is multi-platform: a single source builds platform-native files for Claude Code, Gemini CLI, OpenCode, or Codex CLI. The core runs entirely against your local vault with no integrations. Email and calendar (the Postman agent) is optional and needs the Google Workspace CLI, Hey CLI, or an MCP connector; Apple Contacts sync is optional via the @griches/apple-contacts-mcp server. Note that this installs as a whole framework cloned into your vault and run through a shell installer (launchme.sh), not as a single drop-in skill file.

second-brainobsidianknowledge-managementnote-takingmulti-agentproductivitytranscription

My Brain Is Full Crew is a third-party, MIT-licensed second-brain system by gnekt that runs over an Obsidian vault. It is included here as an aggregate toolkit entry: it installs as a whole framework cloned into your vault and built with a shell installer, not as a single drop-in skill file. The catalog entry pins commit 340be6e49739db61cef722a82482731387927149 so installs run against an immutable revision. The authoritative source is the repo’s README.md at that commit.

Runbook

Setup, step by step

1

Install Claude Code

Download the desktop app from claude.ai/code and sign in. Claude Code needs a Claude Code-capable plan (Pro, Max, Team, or Enterprise) or Console/API billing; the free claude.ai tier does not include it.

2

Install Obsidian and pick a vault

Install Obsidian (the free version is fine) and open or create the vault you want the Crew to manage.

3

Install jq (required), and Node.js if you want integrations

The installer's build step needs jq on your PATH for the Claude Code platform and exits before creating .claude/ if it is missing. Install it: macOS brew install jq, Debian/Ubuntu sudo apt-get install jq, Windows winget install jqlang.jq. Node.js is only needed for optional MCP integrations like email/calendar or Apple Contacts; if you want those, install the LTS build from nodejs.org and verify with node --version. On Windows, the later git clone and bash scripts/launchme.sh steps need a Unix-style shell: install Git for Windows (which provides Git Bash) or use WSL, and run the install commands there.

4

Clone the Crew at the pinned commit

In a terminal inside your vault folder, clone the repo and check out the exact commit this entry pins to, so the code you run matches the revision under review.

git clone https://github.com/gnekt/My-Brain-Is-Full-Crew.git && cd My-Brain-Is-Full-Crew && git checkout 340be6e49739db61cef722a82482731387927149
5

Run the installer and choose Claude Code

Run the shell installer. When prompted for a platform, select Claude Code. It builds the agents and skills, writes a .claude/ directory, and writes a .mcp.json into your vault. If your vault already has a .mcp.json, back it up first: the Claude Code path overwrites it rather than merging, so other MCP servers you configured can be dropped. The installer also copies helper scripts into Meta/scripts/ (overwriting same-named files and rewriting Meta/scripts/.core-manifest) and creates Meta/states/; back up Meta/scripts/ too if your vault already uses it.

bash scripts/launchme.sh
6

Initialize your vault

Open Claude Code inside the vault and say Initialize my vault. From there you talk to the Crew: File all my inbox notes, Run a weekly review, or What did we decide about pricing?

7

(Optional) connect email, calendar, and contacts

For the Postman agent, install the Google Workspace CLI (gws) or Hey CLI, or add an MCP connector, following docs/gws-setup-guide.md. For Apple Contacts, add the @griches/apple-contacts-mcp server to .mcp.json.

One-command install

Install the skill

Install

Install the Crew into your vault

The installer also targets Gemini CLI, OpenCode, and Codex CLI. The steps below assume Claude Code.

This is a whole framework you clone into an Obsidian vault and build with a shell installer, not a single skill file. Install from the pinned commit below.

  1. 1

    Open a terminal in your Obsidian vault

    Use an existing vault or create a new folder and open it in Obsidian first. Then in a terminal, change into that vault folder.

  2. 2

    Install jq, then clone the Crew at the pinned commit

    The installer's build step needs jq on your PATH and exits before creating .claude/ without it (macOS brew install jq, Debian/Ubuntu sudo apt-get install jq, Windows winget install jqlang.jq). Then clone the repo and check out the exact commit this entry pins to, so what you run matches the revision under review.

    git clone https://github.com/gnekt/My-Brain-Is-Full-Crew.git && cd My-Brain-Is-Full-Crew && git checkout 340be6e49739db61cef722a82482731387927149
  3. 3

    Run the installer and pick Claude Code

    Run the installer. When it asks for a platform, choose Claude Code. It builds platform-native agent and skill files, writes a .claude/ config directory, and writes a .mcp.json into your vault. If your vault already has a .mcp.json, back it up first: the Claude Code path overwrites it rather than merging, so MCP servers you configured elsewhere can be dropped. The installer also copies its helper scripts into Meta/scripts/ (overwriting same-named files and rewriting Meta/scripts/.core-manifest) and creates Meta/states/; back up Meta/scripts/ too if your vault already uses that path.

    bash scripts/launchme.sh
  4. 4

    Initialize your vault

    Open Claude Code inside the vault folder and say Initialize my vault. The Architect agent walks you through onboarding.

  5. 5

    (Optional) connect email and calendar

    The Postman agent needs an email/calendar backend. Install the Google Workspace CLI (gws) or the Hey CLI, or wire up an MCP connector, following docs/gws-setup-guide.md. Apple Contacts sync is optional via @griches/apple-contacts-mcp.

GitHub Repo
Troubleshooting
Symptom

bash scripts/launchme.sh doesn't create a .claude/ folder

Fix

Make sure you ran the installer from inside the cloned My-Brain-Is-Full-Crew folder and chose Claude Code when prompted for a platform. Re-run it and pick Claude Code explicitly.

Symptom

Claude Code doesn't see the agents or skills

Fix

Open Claude Code from the vault folder (the one containing the generated .claude/ directory), not from a parent or unrelated directory. Restart Claude Code after the installer finishes.

Symptom

The Postman agent can't read email or calendar

Fix

Postman needs a backend. Install and authenticate the Google Workspace CLI (gws) or Hey CLI, or configure the MCP connector per docs/gws-setup-guide.md. The other 7 agents work with no integration.

Symptom

You want to update to a newer version

Fix

Step 4 leaves you on a detached checkout (a specific commit, not a branch), so a bare git pull fails with "You are not currently on a branch." Switch to the default branch first, then update: git checkout main && git pull && bash scripts/updateme.sh. The updater overwrites .mcp.json the same non-merging way the installer does, so back it up first if you added MCP servers (such as Apple Contacts) after install. Only update if you have reviewed the newer code yourself, since this catalog entry is pinned to a specific commit.