Project brain for
Claude Code
Drop a .claude-project file in any directory.
Get persistent memory, event logs, agent dispatch, automations, session hooks, and auto-generated CLAUDE.md — all wired into Claude Code.
Drop a .claude-project file in any directory.
Get persistent memory, event logs, agent dispatch, automations, session hooks, and auto-generated CLAUDE.md — all wired into Claude Code.
npm install -g claude-project
Structured memory files in your diary folder. Claude reads them at session start and writes discoveries, decisions, and milestones back.
Append-only JSONL event log — every session start, end, tool call, dispatch, and automation fire is timestamped and UUID-tagged.
Trigger automations on events, cron schedules, file changes, or service health transitions. Actions include shell commands, agent dispatch, Obsidian sync, and webhooks.
Queue tasks for Claude agents. The dispatch runner calls the Claude API with a full tool loop — read files, run commands, log events — all sandboxed to your project.
CLAUDE.md is generated and refreshed automatically from your project brain — stage, agents, services, recent events, and dispatch queue included.
Full MCP server with memory, journal, events, dispatch, registry, and project info tools. Works in stdio and HTTP/SSE modes.
Claude Code hooks fire on SessionStart and Stop — logging events, syncing Obsidian, refreshing CLAUDE.md, and triggering automations automatically.
A global registry of all your projects at ~/.claude/registry.json. The daemon keeps it hot — instant project lookup without filesystem scans.
Status bar integration, .claude-project syntax highlighting, JSON Schema validation, and quick-access commands from the command palette.
# 1. Install npm install -g claude-project # 2. Initialise a project cd ~/my-project claude-project init "My Project" -d "What it does" -s "Planning" # 3. Add the MCP server to Claude Code claude-project inject # 4. Install session hooks (fires on every Claude Code session) claude-project hooks install --global # 5. Start the background daemon (macOS) claude-project daemon install # 6. Check project status claude-project status
// .claude-project { "version": "4", "name": "My Project", "agents": { "summariser": { "role": "Daily summariser", "model": "claude-sonnet-4-6", "instructions": "Summarise recent project events concisely.", "tools": ["read_file", "log_event"] } }, "automations": [ { "id": "sync-on-session-end", "trigger": { "type": "event", "event_type": "session_end" }, "action": { "type": "sync_obsidian" } }, { "id": "daily-summary", "trigger": { "type": "schedule", "cron": "0 9 * * *" }, "action": { "type": "dispatch_agent", "agent": "summariser", "prompt": "Summarise yesterday's events." } } ] }