A Local-First, Agent-Centric Personal Knowledge Management System
"The Historian" - Your AI-powered life operating system.
Life-OS is a plain-text file structure designed to be managed by CLI AI Agents (like Claude Code or OpenCode). It turns a simple folder into a powerful, programmable personal database, combining the flexibility of Markdown with the intelligence of LLMs.
- Agent-Native: Built from the ground up to be read and written by AI.
- Local & Private: All data lives in local Markdown files. No cloud lock-in.
- The Historian Persona: Includes a rigorous system prompt (
AGENTS.md) that enforces data integrity and consistency. - Skill-Based Automation: extensible
skills/directory for Python scripts (e.g., daily migration, stats generation). - International Standard: Default structure and logic are in English for maximum compatibility.
Life-OS/
├── AGENTS.md # 🤖 The Constitution: Persona & Rules for the AI Agent
├── 00-Dashboard.md # 📅 The Daily Control Center
├── 01-Inbox.md # 📥 Quick Capture Area
├── 10-Journal/ # 📝 Daily Logs (The History)
│ └── YYYY/
│ └── MM/
│ └── YYYY-MM-DD.md
├── 20-Projects/ # 🚀 Long-term Active Projects
├── 99-Archive/ # 📦 Completed Tasks & Old Projects
└── skills/ # ⚡ Python Scripts for Automation
└── new_day.py # Auto-generates daily logs & migrates tasks
- Python 3.x (for skills)
- An AI CLI Agent (OpenCode, Claude Code, etc.)
-
Initialize the Day: Ask your agent: "Run the new day skill." (Or manually run
python skills/new_day.py) -
Capture Tasks: Ask your agent: "Add 'Buy milk' to my inbox."
-
Review Progress: Ask your agent: "What is on my dashboard today?" or "Summarize what I did last week based on my journals."
The core of this system is AGENTS.md. It instructs any LLM that enters this directory to behave as "The Historian".
Core Mandates:
- Always Check Dashboard First: Context awareness is key.
- Journaling is Sacred: Every action is logged.
- No Silent Failures: Ambiguity requires clarification.
MIT