By hamchowderr
Braynee turns Claude Code into your second brain — setup wizard, PARA vault scaffolding, company knowledge base, project detection, all-time usage insights, and daily workflow skills. Requires Claude Code ≥ 2.1.85 (hooks use the `if` field for tool/argument scoping).
Drain the beads queue autonomously. Loops: bd ready → claim → execute → close → repeat. Use when the user says "autopilot", "drain the queue", "work the backlog", "autonomous mode", "go through ready tasks", or asks for hands-off batch work. CLI-only (no MCP). Stops on empty queue, failed claim, or 3 consecutive failures.
Runs the morning or evening ritual for the vault owner. Use when invoked by /braynee:daily, or when the user says "start my day", "morning review", "what does my day look like", "evening wrap-up", "end of day review", "what do I need to do today", or asks for a daily briefing.
Searches the vault from multiple angles and synthesizes what is known about a topic. Use when the user asks "what do I know about X", "recall everything about Y", "what have I decided about Z", "search my vault for X", "give me a briefing on X", or needs a comprehensive summary of vault knowledge on any subject.
Creates the full vault presence for a new project or client engagement. Use when the user says "set up a new project", "onboard a new client", "create project structure for X", "add X to my vault as a project", or starts describing a new piece of work that needs vault scaffolding.
Process unprocessed Inbox items into structured wiki notes. Use when Inbox has accumulated items to process, or to compile a specific raw note into a proper vault article.
Client relationship management. Look up client context, log engagement notes, track status, and prep for meetings. Use when user says "client notes", "pull up [client name]", "update client", "new client", "prep for [client] call", "log meeting", "client status".
Pulls messages from each client's configured channels (email, Slack), groups them into threads,
Open, create, or update today's daily note. Review yesterday, plan today, log progress. Use when user says "open today", "daily note", "what's today", "log this", "what did I do yesterday", "plan my day", "morning review", "EOD".
Operate Docker locally for dev work — containers, images, Compose stacks, and Docker Desktop lifecycle. Use when the user says "docker", "spin up a container", "what's running", "docker compose up/down", "build an image", "view logs", "exec into", "stop/remove a container", "free up docker space", "prune", "restart docker desktop", "is docker running", or any local Docker task.
Create Excalidraw diagrams in Obsidian using the ExcalidrawAutomate (EA) API. Generates .excalidraw files saved directly to the vault — no external tools needed, Obsidian renders them natively. Two modes: (1) Single diagram on demand for any workflow, architecture, process, or data model — trigger on "diagram this", "draw a flowchart", "create an architecture diagram", "visualize this", "make an Excalidraw". (2) Full codebase walkthrough — autonomously reads a codebase and produces a complete visual system documentation (architecture, data flow, sequence, ER) plus interlinked Markdown notes — trigger on "document this codebase", "walk through this system", "diagram this app", "map out this repo", "create documentation for this project".
Executes bash commands
Hook triggers when Bash tool is used
Modifies files
Hook triggers on file write and edit operations
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Uses power tools
Uses power tools
Uses Bash, Write, or Edit tools
Uses Bash, Write, or Edit tools
Claude Code's second brain — turns your Claude Code sessions into a living, searchable knowledge system backed by an Obsidian vault.
Braynee is a Claude Code plugin that scaffolds a PARA vault, wires up your company knowledge base, detects your environment, installs the right Obsidian plugins, and keeps everything in sync session to session.
Requires Claude Code ≥ 2.1.85. Braynee's hooks use the
iffield to scope by tool and arguments. On older Claude Code theiffield is ignored and the hooks run on every matched call — they still self-gate internally and stay correct, just less efficiently. Update Claude Code for the intended behavior.
Marketplace (recommended):
claude plugin marketplace add hamchowderr/braynee
claude plugin install braynee@braynee
Direct from a release URL (no marketplace) — requires Claude Code ≥ v2.1.128 for zip/URL plugin loading:
claude --plugin-url https://github.com/hamchowderr/braynee/releases/download/braynee--v<version>/braynee.zip
Every braynee--v<version> GitHub Release ships a braynee.zip asset, built automatically when the tag is pushed (claude plugin tag . → git push origin braynee--v<version>). Pin the tag to the version you want.
Braynee creates an org-aware vault structure under 2. Areas/Business/. Each business gets a folder with:
Clients/ — per-client notes, engagement logs, call prepOrg/ — Decisions, Strategy, Competitors, Pipeline, RisksOperations/ — Consulting, Education, Marketing, FulfillmentShipped/ — live products still being maintainedYou provide your company name and email domain during setup; braynee seeds the structure and names everything correctly from the start.
Braynee auto-detects your installed mail client:
Email context is stored in your knowledge base and surfaced during daily planning and client call prep.
Braynee detects your calendar platform and wires it into daily notes:
scan-projects.py scans every common projects-root folder name (code, projects, dev, Developer, repos, src, workspace, work, Sites, source, plus Windows-specific paths like source/repos, Documents/GitHub), finds git repos, detects the stack (Next.js, Convex, FastAPI, etc.), and writes a project map. The wizard surfaces these to Claude so it knows what you're building without you having to explain it.
Braynee declares its hooks in the plugin's hooks/hooks.json — they run automatically when the plugin is active, with nothing written into ~/.claude/settings.json. 37 hooks across 15 Claude Code events keep the vault, sessions, beads, and tasks in sync:
| Event | Hooks | What they do |
|---|---|---|
| SessionStart | ensure-obsidian.js, reinject-after-compact.js, session-auto-track.js, braynee-heartbeat.js, check-beads-init.js, beads-work-surface.js, check-git-init.js, check-testing-setup.js | Launch Obsidian, open/update the session note, write the heartbeat, ensure beads + git are initialized, surface the ready beads queue, flag a missing test stack, and re-inject vault context after a compaction |
| UserPromptSubmit | memory-reminder.js, beads-nudge.js | Remind Claude to search vault memory before guessing and to keep the beads workflow current |
| PreToolUse | check-no-main-push.js, branch-name-check.js | Protect main/master: block pushing to it, committing on it, or --orphan-ing onto it (opt out with BRAYNEE_ALLOW_MAIN_COMMITS=1), and enforce branch naming |
| PostToolUse | memory-index-sync.js, plan-capture.js, session-note-nudge.js, statusline-state.js, commit-cadence-nudge.js, beads-claim-to-branch.js, beads-status-sync.js, beads-todo-reminder.js, beads-dashboard-refresh.js, mtn-to-beads-sync.js | Keep MEMORY.md indexed, capture approved plans, nudge session-note updates and commit cadence, branch on bd … --claim, and mirror beads ⇄ Claude todos ⇄ TaskNotes |
| PostToolBatch | beads-batch-reconcile.js | Reconcile beads state after batched tool calls |
| PreCompact | pre-compact-snapshot.js | Snapshot context before a compaction |
| PostCompact | post-compact.js | Restore and re-inject context after a compaction |
| Stop | session-auto-close.js, session-export-qmd.js, session-stop-check.js, beads-stop-check.js, stop-task-verify.js | Close the session, export the transcript and refresh the QMD index, and run the session-close / beads / task checklists |
| StopFailure | stop-failure.js | Detect a Stop that didn't produce a clean wrap |
npx claudepluginhub hamchowderr/braynee --plugin brayneeGenerate a comprehensive HTML insights report from your ENTIRE Claude Code history — every session, every project, all time. The built-in /insights covers recent activity; Insightful covers everything.
Harness-native ECC operator layer - 67 agents, 271 skills, 92 legacy command shims, reusable hooks, rules, selective install profiles, and production-ready workflows for Claude Code, Codex, OpenCode, Cursor, and related agent harnesses
Superpowers Plus core skills library for Claude Code: planning, execution routing, TDD, debugging, and collaboration workflows
Claude harness - A harness for solo developers (Vibecoders) to handle full-cycle contract development.
AI-powered development tools for code review, research, design, and workflow automation.
Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
v9.44.1 — Patch release for Gemini environment/version detection and qwen auth gating. Run /octo:setup.