Firstbrain

AI-Native Second Brain, Execution Engine & Knowledge Graph
You think. Claude organizes, codes, ships, and discovers connections.

Features • Quick Start • Execution Engine • Knowledge Graph • Skills • Architecture • Governance • Memory

What is Firstbrain?

Firstbrain turns an Obsidian vault into an AI command center. Claude Code organizes your notes, executes your instructions (writing code, creating projects, pushing to GitHub), and discovers hidden connections in your knowledge using graph algorithms -- all documented as interconnected markdown.

Without Claude Code -- a structured Obsidian starter vault (PARA folders, 12 templates, 9 MOCs).

With Claude Code -- a second brain that thinks, builds, ships, and understands its own structure.

Cheatsheet -- All 15 skills with every command, subcommand, and flag. Copy & paste ready.

Features

Quick Start

One-Click Launcher

Double-click to start. The launcher checks Node.js, Claude Code CLI, validates the vault, and launches:

start.sh (Linux/macOS) • start.bat (Windows) • start.command (macOS Finder)

Manual Setup

Quick Start

Execution Engine

Knowledge Graph

Built-in graph engine analyzes your vault's structure with zero external dependencies.

/graph -- PageRank ranking, topic clusters, shortest paths, bridge detection, structural similarity, multi-hop discovery. Read-only, never modifies files.

/propose -- Finds emergent patterns and suggests improvements: new MOCs for tag clusters (5+ notes), missed connections (3+ shared tags, no link), hub candidates (high PageRank notes), orphan rescue (isolated notes matched to best links). All proposals require user approval.

/connect v3 -- Three signal layers: direct (tags + links), multi-hop (2-3 hops via graph), structural similarity (Jaccard on neighborhoods).

Skills

Architecture

Vault Structure

Scanning Pipeline

Governance

Memory System

Memory Architecture

Roadmap

v1.0 -- Foundation, scanning, 7 core skills, semantic search, 4-layer memory (2026-03-07)
v1.1 -- Proactive Intelligence: /briefing, /triage, /synthesize, /maintain (2026-03-08)
v2.0 -- Execution Engine, /process, /watch, workspace/, ACTION:/TASK: markers, guided onboarding, prompt injection defense (2026-04-07)
v3.0 -- Knowledge Graph Engine, /graph (PageRank, clusters, bridges, paths), /propose (emergent structure), /connect v3 (multi-hop + structural similarity) (2026-04-07)
v4.0 -- Temporal analysis, automated weekly digests, cross-vault federation

Contributing

Ideas, bugs, or new templates? See CONTRIBUTING.md.

git clone https://github.com/YOUR_USERNAME/Firstbrain.git
cd Firstbrain && git checkout -b feature/my-feature
# Make changes, then:
git commit -m "feat: add my feature" && git push origin feature/my-feature

License

CC BY-NC 4.0 -- Free for personal and non-commercial use. For commercial licensing, contact the author.

_{Built with Obsidian + Claude Code}