PersonalOS

Your AI-powered task management system that keeps you focused on what matters.

Brain dump into BACKLOG.md, tell your AI assistant to process it, and get organized tasks automatically prioritized based on your goals.

Section	Status
Task Management	✅
Goal-driven Prioritization	✅
Knowledge Base	✅
Backlog Processing	✅
Session Evals	✅
MCP Server (optional)	✅

---

Quick links: Quick Start · How It Works · Directory Structure · Daily Workflow

---

Quick Start

1. Clone the Repository

git clone https://github.com/amanaiproduct/personal-os.git
cd personal-os

2. Run Setup (2 minutes)

./setup.sh

The setup will: - Create your workspace directories - Guide you through questions about your goals and priorities - Generate your personalized GOALS.md - Copy template files

Note: Python 3.10+ is only needed if you want to run the MCP server. The basic setup works with just bash.

3. Start Using It

# In your AI assistant (Claude Code, etc.)
"Read AGENTS.md and help me get organized"

How It Works

1. Brain dump - Drop notes into BACKLOG.md (no structure needed)
2. Process - Say "process my backlog" to your AI
3. Get organized - AI creates prioritized tasks based on your GOALS.md
4. Stay focused - Ask "what should I work on?" for smart suggestions

Common Commands

• "Process my backlog" - Turn notes into tasks
• "What should I work on?" - Get AI suggestions
• "Show me my P0 tasks" - See urgent items
• "Mark [task] as done" - Complete work

Priorities

Priority	Meaning	Limit
P0	Do today	max 3
P1	This week	max 7
P2	Scheduled	-
P3	Someday/maybe	-

Directory Structure

personal-os/
├── core/                    # Reusable system components (public)
│   ├── evals/              # Session evaluations
│   ├── mcp/                # MCP server implementation
│   │   └── server.py       # Core server with deduplication
│   ├── templates/          # Template files for users
│   │   ├── AGENTS.md       # Comprehensive AI instruction template
│   │   ├── config.yaml     # Configuration template
│   │   └── gitignore       # Gitignore template
│   └── README.md           # Core system documentation
│
├── Tasks/                  # Your personal tasks (gitignored)
├── Knowledge/              # Reference docs & notes (gitignored)
├── BACKLOG.md             # Your backlog inbox (gitignored)
├── GOALS.md               # Your personalized goals (generated by setup)
├── AGENTS.md              # Your AI agent instructions
└── setup.sh               # Interactive setup script

Daily Workflow

Morning: "Show me today's priorities" → Pick 1-3 tasks

During work: Brain dump into BACKLOG.md, save docs to Knowledge/

End of day: "Mark [task] as done"

Weekly: "Process my backlog" + "Clean up old tasks"

Features

• Goal-driven prioritization based on your vision
• Smart deduplication detects duplicate tasks
• Natural language - just talk to your AI
• Session evals to review and learn from AI interactions
• 2-minute setup, no Python required
• MCP integration for Claude and other AI assistants

For Contributors

The core/ directory contains the reusable system. Contributions should: - Not include personal information - Be generic and configurable - Include documentation - Follow the existing patterns

License

This work is licensed under CC BY-NC-SA 4.0.

Copyright © 2025 Aman Khan. You may view, use, modify, and share this repo with attribution for non-commercial purposes. Commercial sale is not permitted, but you may use it internally for work and business.

Full license: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode