Life OS

1# Life OS
2 
3A personal filesystem that works as your life operating system — designed to be read, queried, and operated on by an AI agent.
4 
5## What This Is
6 
7Life OS is a structured set of markdown files that give an AI agent (Goose, Claude, or any LLM with filesystem access via MCP) persistent context about your life — who you are, what you're working on, what you're learning, and what's happened. The AI reads these files at the start of every session and operates on your life with the same coherence an operating system operates on system state.
8 
9## Quick Start
10 
111. Clone this repo to your machine
122. Open the folder with your AI agent (Goose, Claude Code, etc.)
133. Tell the agent: **"Read SETUP.md and help me configure my Life OS"**
144. Answer the agent's questions — setup takes ~5 minutes
155. Start using it
16 
17## How It Works
18 
19```
20You ←→ AI Agent ←→ Life OS Filesystem (via MCP)
21```
22 
23The AI agent connects to your filesystem through MCP (Model Context Protocol). It can read any file for context and write updates when you make decisions, complete tasks, or capture new information.
24 
25## Structure
26 
27| Folder | Purpose | Changes How Often |
28|--------|---------|-------------------|
29| `me/` | Who you are, how the system works, what tools are available | Weekly or less |
30| `learn/` | What you're actively studying or researching | As needed |
31| `do/` | Active projects and life area indexes | Daily |
32| `log/` | Journal entries, decision records | Daily (append-only) |
33 
34## Key Principle
35 
36**The filesystem is the single source of truth.** The AI has no memory between sessions. Everything it knows about you comes from these files. Keep them current, and the AI stays current.
37 
38## Creating New Things
39 
40- **New project:** Copy `do/_project-template/` to `do/your-project-name/`
41- **New learning topic:** Copy `learn/_template.md` to `learn/your-topic.md`
42- **New skill:** Copy `me/skills/_template.md` to `me/skills/your-skill.md`
43- **New journal entry:** Copy `log/journal/_template.md` to `log/journal/YYYY-MM-DD.md`
44 
45Or just ask your AI agent to create them — it knows the templates.
46