A complete personal knowledge management system that combines Obsidian's powerful note-taking with Claude Code's AI assistance. Go from zero to a fully functional PKM in 15 minutes or less.

✨ Features

🎯 Goal-Aligned System - Cascading goals from 3-year vision to daily tasks
🤖 AI-Powered Workflows - Claude Code integration for intelligent note management
📅 Daily Notes System - Structured daily planning and reflection
📱 Mobile Ready - GitHub integration for notes on any device
🔄 Version Controlled - Never lose a thought with automatic Git backups
⚡ Automated Commands - Custom slash commands for common workflows
🎨 Fully Customizable - Adapt templates and structure to your needs

🚀 Quick Start

Prerequisites

Obsidian installed
Claude Code CLI installed
Git installed
GitHub account (optional, for mobile sync)

15-Minute Quickstart

# 1) Install prerequisites (once)
# - Obsidian: https://obsidian.md/
# - Git: https://git-scm.com/
# - Claude Code CLI: https://docs.anthropic.com/en/docs/claude-code

# 2) Clone this repository
git clone https://github.com/ballred/obsidian-claude-pkm.git
cd obsidian-claude-pkm

# 3) Run setup (macOS/Linux)
chmod +x scripts/setup.sh
./scripts/setup.sh

# 3b) Windows
scripts\setup.bat

Manual Copy (alternative)

# Copy the vault template to your preferred location
cp -r vault-template ~/Documents/ObsidianPKM

Open in Obsidian

Launch Obsidian
Click "Open folder as vault"
Select your vault folder (e.g., ~/Documents/ObsidianPKM)
Start with today's daily note!

📖 Documentation

Setup Guide - Detailed installation instructions
Customization - Make it yours
Workflow Examples - Daily routines and best practices
Troubleshooting - Common issues and solutions

🗂️ Structure

Your Vault/
├── CLAUDE.md           # AI context and navigation
├── .claude/
│   └── commands/       # Custom slash commands
├── Daily Notes/        # Your daily journal
├── Goals/              # Cascading goal system
├── Projects/           # Active project folders
├── Templates/          # Reusable note templates
└── Archives/           # Historical content

🤝 Contributing

Found a bug or have a feature idea? Please open an issue or submit a PR!

📄 License

MIT - Use this freely for your personal knowledge management journey.

Ready to transform your note-taking? Follow the Setup Guide to get started!