📊 Take the quick poll - Help shape what gets built next!

---

Obsidian + Claude Code: AI Accountability System

Not another PKM starter kit. This is an execution system that connects your 3-year vision to what you do today — and holds you accountable with AI.

3-Year Vision ──→ Yearly Goals ──→ Projects ──→ Monthly Goals ──→ Weekly Review ──→ Daily Tasks
                                      ↑
                              /project new
                         (the bridge layer)

Every layer connects. /daily surfaces your ONE Big Thing from the weekly review. /weekly shows project progress. /monthly checks quarterly milestones. /goal-tracking knows which goals have no active project. Nothing falls through the cracks.

v3.1 · Zero dependencies · MIT License

The Cascade

The #1 reason people star this repo: "I want goals → projects → daily notes → tasks to actually connect."

Layer	File	Skill	What It Does
Vision	Goals/0. Three Year Goals.md	/goal-tracking	Life areas, long-term direction
Annual	Goals/1. Yearly Goals.md	/goal-tracking	Measurable objectives, quarterly milestones
Projects	Projects/*/CLAUDE.md	/project	Active initiatives linked to goals
Monthly	Goals/2. Monthly Goals.md	/monthly	Roll up weekly reviews, check quarterly progress
Weekly	Goals/3. Weekly Review.md	/weekly	Reflect, realign, plan next week
Daily	Daily Notes/YYYY-MM-DD.md	/daily	Morning planning, evening reflection

How It Flows

Morning — /daily creates today's note, shows your week's ONE Big Thing and active project next-actions. You pick your focus.

Evening — /daily summarizes which goals and projects got attention today. Unlinked tasks get flagged.

Sunday — /weekly reads all your daily notes, scans project status, calculates goal progress, and helps you plan next week. Optional agent team mode parallelizes the collection.

End of month — /monthly rolls up the weekly reviews, checks quarterly milestones against yearly goals, and sets next month's priorities.

Ad hoc — /project new creates a project linked to a goal. /project status shows a dashboard. /review auto-detects the right review type based on context.

Quick Start

Prerequisites

• Obsidian installed
• Claude Code CLI installed
• Git installed

Setup

# Clone and set up
git clone https://github.com/ballred/obsidian-claude-pkm.git
cd obsidian-claude-pkm
chmod +x scripts/setup.sh && ./scripts/setup.sh

# Open vault in Obsidian, then start Claude Code:
cd ~/your-vault-location
claude

On first run, you'll see a welcome message with the cascade visualization. Run /onboard to personalize your vault — it asks your name, preferred review day, and goal areas, then configures everything.

Already have a vault?

You don't need to start from the template. Run /adopt from the root of your existing Obsidian vault — it scans your folder structure, detects your organization method (PARA, Zettelkasten, LYT, etc.), maps your folders interactively, and generates all config files scoped to your directory names. Your vault structure stays untouched.

cd ~/your-existing-vault
claude
# then type: /adopt

Windows