personal-os

一套让任何 LLM 都能驱动的 Obsidian Personal OS

An AI-friendly Obsidian Personal OS · Talk to any LLM, it drives your vault

🌐 Live Docs · 📖 AGENTS.md · 📜 The 48-Hour Story · 🤝 Contributing

---

Say "我准备睡了" → AI starts your evening review → asks 6 questions → writes today's journal → carries unfinished tasks to tomorrow. No GUI. No buttons. Just talk.

I quit 7 PKM systems in 5 years. Every one of them died the same way: I'd spend weekends setting it up, weeks tweaking, then drift back to Apple Notes.

The pattern was: the system needed me to maintain it. Click here. Drag there. Fill in 12 fields. Remember the right tag.

This one is different. You talk; the AI does the maintenance.

The breakthrough wasn't more plugins or fancier CSS. It was a 770-line protocol called AGENTS.md — a contract any LLM can read so it knows how to drive your vault when you say things like "今晚聊聊" or "track $35 for coffee" or "I have an idea".

Read the full 48-hour build story in STORY.md.

You:   我准备睡了

AI:    在睡之前花 5 分钟过一下今天 ✨

       1️⃣ 今日最满意的一件事？

You:   把论文 Method 章节写完了

AI:    💨 今日最大的浪费？

You:   早上刷 X 刷掉 40 分钟

AI:    ➡️ 明日最重要的一件事？

You:   写 Experiments baseline

AI:    🙏 感恩 3 件 · 心情/精力/专注 1-10 · 一句话总结

You:   [answers]

AI:    ✅ 写入今日日记.

       🌫 今天还没勾的有 2 条：
       1. 打电话给妈妈
       2. 跑健身房
       怎么处理? (c=明天 / x=取消 / w=下周)

You:   1c 2c

AI:    ✅ 推到明天. 明天最重要的是「Experiments baseline」.
       再添 2 件大事? 中午 sushi, 晚上读书, 加进去? ...

The AI knows what to ask, when, and where to write the answer. You don't maintain the system. You answer questions.

git clone https://github.com/guanxiaol/personal-os ~/personal-os
# or any sync folder you prefer:
# iCloud:  ~/Library/Mobile\ Documents/com~apple~CloudDocs/personal-os
# Dropbox: ~/Dropbox/personal-os

Download Obsidian → "Open folder as vault" → point at the cloned dir → click Trust author and enable plugins.

Then just say "今天聊聊", "plan my morning", "track 35 for coffee", or "I have an idea about ...".

Edit _profile.md (or copy any preset from _profiles/) to switch the AI's entire vibe.

💡 Don't see your style? Open an issue with the New Profile template — we want presets for parents, grad students, founders, shift workers, athletes...

┌──────────────────────────────────────────────────────────────────┐
│ Layer 5 · UI                                                     │
│   AnuPpuccin theme + 6 CSS snippets (glass / banners / chips)   │
├──────────────────────────────────────────────────────────────────┤
│ Layer 4 · View                                                   │
│   Bases (Card/Table/Kanban) + Full Calendar + Dataview          │
├──────────────────────────────────────────────────────────────────┤
│ Layer 3 · Input                                                  │
│   Meta Bind (inline) + Modal Forms (popups) + Templater (macros)│
├──────────────────────────────────────────────────────────────────┤
│ Layer 2 · Schema                                                 │
│   13 entity types · all share id/type/status/refs/tags          │
├──────────────────────────────────────────────────────────────────┤
│ Layer 1 · Storage                                                │
│   markdown + YAML · iCloud (L1) + Git (L2) + .cache (L3)        │
└──────────────────────────────────────────────────────────────────┘

13 entity types: task · event · goal · project · paper · repo · book · workout · meal · expense · habit · person · idea · link · microlog

Each has a strict YAML frontmatter contract (see AGENTS.md §6).

Home dashboard

Apple Calendar-style week view

Modal Forms · Things 3 style quick-add

Meta Bind property bar · Linear / Notion style

Morning + evening rituals

Bases · 13 databases, 4 views each

🌐 See all mockups + interactive docs at guanxiaol.github.io/personal-os

10 community plugins + 1 Obsidian core feature. Every other "kitchen sink" plugin was tried and cut. See CHANGELOG.md for what we removed and why.

Most-wanted contributions:

• 🌍 New _profile.md presets — parent / grad student / founder / monk / shift worker / athlete
• 🌐 Translations of AGENTS.md + README.md to JP / KR / ES / FR / RU
• 🎨 CSS variants — cyberpunk, terminal, brutalist, watercolor
• ✨ New trigger phrases in your native language

See CONTRIBUTING.md for the full guide.

• Obsidian — the markdown editor this is built on
• Tiago Forte's PARA method — Projects/Areas/Resources/Archives organizing
• AGENTS.md spec — emerging convention for agent operating manuals
• Things 3 — input UX inspiration
• Linear — property chip inspiration
• Sunsama — daily ritual inspiration
• NickMilo's LYT — Obsidian PKM thinking
• The Claude Code team for building a tool good enough to pair-program a Personal OS in 48 hours

MIT · do whatever you want, just keep the copyright.

If this saves you time, a ⭐ helps the algorithm find more people like you.