AI-Native Second Brain, Execution Engine & Knowledge Graph
You think. The AI organizes, codes, ships, and discovers connections.
Features • Quick Start • Execution Engine • Knowledge Graph • Skills • Architecture • Governance • Memory
Firstbrain turns an Obsidian vault into an AI command center. Your AI agent 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 an AI agent -- a structured Obsidian starter vault (PARA folders, 12 templates, 9 MOCs).
With an AI agent -- 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.
Double-click to start. The launcher checks Node.js, the AI CLI, validates the vault, and launches:
start.sh (Linux/macOS) • start.bat (Windows) • start.command (macOS Finder)
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).
- 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),/connectv3 (multi-hop + structural similarity) (2026-04-07) - v4.0 -- Temporal analysis, automated weekly digests, cross-vault federation
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-featureCC BY-NC 4.0 -- Free for personal and non-commercial use. For commercial licensing, contact the author.
Built with Obsidian + AI Agents