A personal filesystem that works as your life operating system — designed to be read, queried, and operated on by an AI agent. Life 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 t
Add this skill
npx mdskills install picturpoet/life-osStructured markdown filesystem for persistent AI agent context about personal life data
A personal filesystem that works as your life operating system — designed to be read, queried, and operated on by an AI agent.
Life 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.
You ←→ AI Agent ←→ Life OS Filesystem (via MCP)
The 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.
| Folder | Purpose | Changes How Often |
|---|---|---|
me/ | Who you are, how the system works, what tools are available | Weekly or less |
learn/ | What you're actively studying or researching | As needed |
do/ | Active projects and life area indexes | Daily |
log/ | Journal entries, decision records | Daily (append-only) |
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.
do/_project-template/ to do/your-project-name/learn/_template.md to learn/your-topic.mdme/skills/_template.md to me/skills/your-skill.mdlog/journal/_template.md to log/journal/YYYY-MM-DD.mdOr just ask your AI agent to create them — it knows the templates.
Install via CLI
npx mdskills install picturpoet/life-osLife OS is a free, open-source AI agent skill. A personal filesystem that works as your life operating system — designed to be read, queried, and operated on by an AI agent. Life 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 t
Install Life OS with a single command:
npx mdskills install picturpoet/life-osThis downloads the skill files into your project and your AI agent picks them up automatically.
Life OS works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Gemini Cli, Amp, Roo Code, Goose. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.