Architecture as of v1.9.0: Life OS is 100% markdown โ agent prompts, slash commands, eval scenarios, RFC documents. No Python (
tools/removed in v1.8.1 Wave 2), no bash hooks (scripts/hooks/*.shretired in v1.8.5), no .yml schema files (v1.8.7 md-only ontological commit per DR-10). Runtime enforcement happens via inline LLM procedures driven by spec.md reading + grep matching. Hermes Local was the original name for the v1.6-v1.8.0 bash hook + Python tools layer; that layer no longer exists. Pattern provenance preserved: forked from NousResearch/hermes-agent under the MIT License.Historical sections below (v1.8.3 / v1.8.0 / v1.6.3a "What's New") may reference
bash scripts/setup-hooks.shand similar โ those steps are no-op since v1.8.5 (hook layer retired). For current setup, run/install-agentsin Claude Code (one slash command, replaces all historical bash setup scripts).
Life OS installs into your AI terminal (Claude Code, Gemini CLI, or Codex CLI) and transforms it into a personal cabinet โ multiple independent AI agents that analyze your decisions from every angle, argue with each other, and hold both the plan and you accountable.
The decision engine is the same for everyone: plan, review, veto, execute, audit. What changes is the world it speaks.
When you first start a session, you pick a theme:
๐จ Choose your theme:
English:
a) ๐๏ธ Roman Republic โ Consul, Tribune, Senate
b) ๐บ๐ธ US Government โ Chief of Staff, Attorney General, GAO
c) ๐ข C-Suite โ CEO, General Counsel, CFO
ไธญๆ:
d) ๐๏ธ ไธ็ๅ
ญ้จ โ ไธ็ธใไธญไนฆ็ใ้จไธ็
e) ๐จ๐ณ ไธญๅฝๆฟๅบ โ ๅฝๅก้ขๆป็ใๅๆนๅงใไบบๅคงๅธธๅงไผ
f) ๐ข ๅ
ฌๅธ้จ้จ โ ๆป็ป็ใๆ็ฅ่งๅ้จใๆณๅกๅ่ง้จ
ๆฅๆฌ่ช:
g) ๐๏ธ ๆๆฒปๆฟๅบ โ ๅ
้ฃ็ท็ๅคง่ฃใๅ่ญฐใๆขๅฏ้ข
h) ๐๏ธ ้ใ้ข โ ๅ
้ฃๅฎๆฟ้ทๅฎใๅ
้ฃๆณๅถๅฑใ่ฒกๅ็
i) ๐ข ไผๆฅญ โ ็คพ้ทๅฎคใ็ตๅถไผ็ป้จใๆณๅ้จ
Type a-i
Here is the same decision โ "Should I leave my job?" โ through all three:
ไธ็ๅ
ญ้จ ้ใ้ข C-Suite
โโโโโโโโโ โโโโโโโโโ โโโโโโโโโ
๐ ไธญไนฆ็ ่ตท่ๆนๆก ๐ ๅ
้ฃๅบ ่ตทๆก ๐ VP Strategy drafts plan
๐ ้จไธ็ ๅฐ้ฉณ๏ผ ๐ ๅ
้ฃๆณๅถๅฑ ๅทฎใๆปใ๏ผ ๐ General Counsel vetoes:
"่ดขๅก่ท้ๆช่งฃๅณ" "่ฒกๅ็ไฝ่ฃใไธๆ" "Runway not addressed"
๐ฐ ๆท้จ 5/10 ๐ฐ ่ฒกๅ็ 5/10 ๐ฐ CFO 5/10
โ๏ธ ๅ
ต้จ 6/10 โ๏ธ ้ฒ่ก็ 6/10 โ๏ธ VP Ops 6/10
โ๏ธ ๅ้จ 4/10 โ๏ธ ๆณๅ็ 4/10 โ๏ธ CCO 4/10
๐ฑ ๅพกๅฒๅฐ ๅฎกๆ ธ ๐ฑ ไผ่จๆคๆป้ข ็ฃๆป ๐ฑ Internal Audit audits
๐ฌ ่ฐๅฎ ่ฟฝ้ฎไฝ ๐ฌ ๅ
้ฃๅไธใๅใ่ฟใ ๐ฌ Exec Coach challenges you
๐ ๅฅๆ: 5.8/10 ๐ ้ฃ่ญฐๆฑบๅฎๆธ: 5.8/10 ๐ Executive Brief: 5.8/10
Nine different worlds. Identical rigor underneath. Each language offers three governance styles โ historical, modern government, and corporate โ so every user finds a voice that fits. A Japanese user picks between Meiji-era ministers, Kasumigaseki bureaucrats, or corporate departments. An English user chooses Roman senators, US federal officials, or C-Suite executives. A Chinese user selects Tang Dynasty mandarins, modern State Council roles, or corporate divisions.
Theme determines language. After you pick a theme, every word of output โ every agent, every report, every response โ is in that theme's language. Chinese for ไธ็ๅ ญ้จ. Japanese for ้ใ้ข. English for C-Suite. No mixing, no exceptions.
Theme is per-session. Each terminal window can use a different theme independently. You can switch mid-session at any time by saying "switch theme" (or "ๅๆขไธป้ข" or "ใใผใๅใๆฟใ"). The engine never changes โ only the voice.
Auto-inference from trigger words. Say "ไธๆ" and the ไธ็ๅ ญ้จ theme loads automatically (ๅๆ-specific). Say "้ฃ่ญฐ้ๅง" and the ้ใ้ข theme loads (modern government-specific). Generic triggers like "ๅผๅง", "ใฏใใใ", or "start" show that language's three sub-choices โ because the word alone does not distinguish historical, government, or corporate.
Not role-playing. Each agent runs as a real, isolated subagent. They cannot see each other's reasoning. They score independently. They disagree.
Life OS is now a markdown-only, GitHub-backed decision system. The current user path is natural language first: after installation, say what you want to do, and ROUTER maps it to the right workflow. Slash commands remain as setup and maintenance plumbing, not the daily interface.
For release history, use CHANGELOG.md and docs/reference/version-history.md. Old v1.6-v1.8 architecture notes live under docs/history/; they are preserved for context but are not the current operating guide.
Life OS rests on five pillars. The decision engine is the core โ everything else grows from it.
The engine runs multiple agents organized around a principle that is 1,400 years old: no single voice goes unchecked. The theme gives those agents names from your culture. The logic is always the same.
| Agent | Function |
|---|---|
| ROUTER | Your primary entry point โ handles casual chat, routes complex matters to the engine |
| PLANNER | Breaks your situation into 3-6 dimensions and builds a structured plan |
| REVIEWER | Independent review with emotional audit, 10/10/10 regret test, SOUL consistency check, red-team challenge, and veto power (max 2 rounds) |
| DISPATCHER | Detects dependencies between domains, dispatches parallel or sequential execution |
| PEOPLE | Relationships, stakeholders, team dynamics |
| FINANCE | Money, assets, risk exposure |
| GROWTH | Learning, personal brand, communication |
| EXECUTION | Action plans, logistics, timelines |
| GOVERNANCE | Rules, risk, compliance, self-discipline |
| INFRA | Health, energy, living environment, digital infrastructure |
| AUDITOR | Audits the agents' work quality after every flow |
| ADVISOR | Audits you โ surfaces behavioral patterns across your decisions |
| COUNCIL | Cross-domain debate โ auto-triggers when domain scores differ by 3+ points |
| RETROSPECTIVE | Session start: sync, briefing, strategic overview |
| ARCHIVER | Session close: archive, knowledge extraction, DREAM, sync |
| STRATEGIST | Hall of Wisdom โ 93 thinkers across 18 domains, 3 dialogue modes |
Every major decision passes through three stages. No shortcuts.
Draft โ The PLANNER breaks your situation into dimensions and builds a plan.
Review โ The REVIEWER examines the plan independently. It runs an emotional audit: Is fear driving this? Will your family support it? Will you regret this in 10 minutes, 10 months, 10 years? It checks alignment with your SOUL (values archive), your wiki (established knowledge), and your strategic map (cross-project impact). It red-teams the weakest assumption. If it finds a blind spot, it sends a veto โ the plan goes back for revision. Maximum two veto rounds; the third pass must be approved.
Execute โ Six domain analysts each score the plan 1-10 from their domain, independently:
| Domain | What it covers | The question it asks |
|---|---|---|
| People | Relationships, stakeholders | "Are the right people involved?" |
| Finance | Money, assets, resources | "Can you afford this โ including the worst case?" |
| Growth | Learning, expression, culture | "What do you need to learn first?" |
| Execution | Action, logistics, timelines | "What's the concrete plan, week by week?" |
| Governance | Rules, risk, compliance | "What happens if everything goes wrong?" |
| Infrastructure | Health, energy, environment | "Can your body and environment sustain this?" |
Each domain has four specialized divisions. Finance, for example, has Income (salary, side income), Spending (budgets, habits), Assets (investments, real estate), and Reserves (emergency fund, insurance, retirement). The DISPATCHER routes to the right divisions automatically.
After all six report, the REVIEWER does a final review โ and if scores conflict by 3+ points, the COUNCIL convenes a structured three-round debate. Then the composite Summary Report is produced. The AUDITOR checks the agents' work ("The execution plan has no milestones past month 3 โ flag it"). The ADVISOR turns to you: "You've avoided addressing finances in your last four decisions. Why?"
Here is what the full flow looks like:
You: "I'm thinking about leaving my job to start something new."
Draft
๐ Planner โ Breaks it into 6 dimensions, builds the plan
Review
๐ Reviewer โ Emotional audit: running away or running toward?
10/10/10 test: will you regret this in 10 years?
SOUL check: aligned with your stated values?
Veto: "Financial runway not addressed. Revise."
Execute (after revision passes review)
๐ฅ People 7/10 "Co-founder chemistry is untested"
๐ฐ Finance 5/10 "18 months runway, but only if nothing goes wrong"
๐ Growth 8/10 "Strong domain expertise, credibility is real"
โ๏ธ Execution 6/10 "No milestone plan past month 3"
โ๏ธ Governance 4/10 "Non-compete clause needs legal review"
๐๏ธ Infra 7/10 "Health is good, but stress plan is vague"
Audit
๐ฑ Auditor โ "Execution plan is vague past month 3 โ request revision"
๐ฌ Advisor โ "You've been consuming startup content for weeks.
Confirmation bias is likely. When did you last
seriously consider staying?"
๐ Final Report โ Composite: 6.2/10 โ Proceed with conditions
Not every request needs a full court process. The ROUTER handles casual chat, quick questions, and emotional support directly. For questions that need domain expertise but are not decisions โ say, "what tax rules apply to freelancers?" โ an express path sends it to 1-3 relevant domain analysts directly, skipping the PLANNER, REVIEWER, AUDITOR, and ADVISOR. Quick answer, then: "This was an express analysis. Want the full deliberation?"
Some questions do not have a "correct answer." They need perspective.
The STRATEGIST gives you access to 93 of history's greatest thinkers across 18 domains โ from Socrates to Buffett, Laozi to Mandela, Dostoevsky to Feynman. Each one runs as a real subagent with their own voice, their own examples, their own way of pushing you.
Three modes:
- One-on-one โ Deep dialogue with a single thinker. Socrates will not let you off easy.
- Roundtable (2-4 thinkers) โ Multiple thinkers discuss your question, each from their worldview. Watch Seneca and Wang Yangming find unexpected common ground.
- Debate (2 thinkers) โ Two thinkers with opposing views argue directly over three structured rounds. You judge.
You: "I keep starting things and never finishing them."
Strategist: Recommended โ Seneca (on time) + Wang Yangming (on action)
Seneca: "You do not lack time. You waste it on things you have not
examined. Which of your current pursuits would you begin again,
knowing what you know now?"
Wang Yangming: "Knowledge and action are one. If you truly knew what you
wanted, you would already be doing it. The gap between
knowing and doing is the gap between wanting and truly
wanting."
โ Parting words from each thinker
โ Summary of your thinking journey saved to your knowledge base
18 domains: Philosophy, Eastern Thought, Science, Strategy, Business, Psychology, Systems, Human Nature, Civilization, Adversity, Aesthetics, Politics, Economics, Mathematics, Medicine, Exploration, Communication, Law.
You can name anyone not on the built-in list โ any historical figure โ and the STRATEGIST will honor the request with equal depth. If your SOUL archive exists, the STRATEGIST uses it to recommend thinkers who address your specific tensions and contradictions.
Every decision, insight, pattern, and action item is written to a persistent knowledge base โ structured markdown files that you own, in a storage system you choose.
second-brain/
โโโ SOUL.md # Who you are โ values, identity, aspirations
โโโ user-patterns.md # How you behave โ the advisor's observations
โโโ inbox/ # Quick captures from your phone
โโโ meta/
โ โโโ STATUS.md # Global status dashboard
โ โโโ STRATEGIC-MAP.md # Relationships between projects
โ โโโ strategic-lines.md # Strategic line definitions
โ โโโ journal/ # Session reports, DREAM reports
โ โโโ outbox/ # Session staging area (one subdirectory per session)
โโโ projects/{name}/ # Active projects with tasks + decisions
โโโ areas/{name}/ # Ongoing life areas with goals
โโโ wiki/ # Reusable knowledge โ grows from DREAM
โโโ archive/ # Completed work
GitHub-backed storage โ a single git repository:
| Layer | What it is |
|---|---|
| Local working copy | The files on disk โ also your Obsidian vault. Where you read and write. |
| GitHub remote | Backup + cross-device sync. git push at session close, git pull at session start. |
It's just git. Versioning, backup, and multi-device sync come for free โ there's no separate sync engine, no primary/mirror split, no conflict-resolution layer. (Google Drive + Notion were removed; storage is GitHub-only.)
Cross-device sync: Edit on your laptop, git push. Sit down at your desktop, start a session, and the system git pulls the changes in. Conflicts are ordinary git merge conflicts โ rare for a single-user vault.
Parallel sessions: Work on project-alpha in one terminal window, project-beta in another. Each session writes to its own outbox directory. The next time you start a session, everything merges cleanly โ no conflicts, no locks.
First-run setup: On your very first session, the system detects that no second-brain exists and walks you through creating one โ it initializes the git repo (local working copy + optional GitHub remote) and the full directory structure automatically.
You are good at thinking about individual projects. You are probably bad at seeing how they connect โ which ones feed into each other, which ones compete for your time, and what happens to the rest when one stalls.
Strategic Map adds the relationship layer.
Strategic Lines โ Group projects by the purpose they serve. Each line has a stated purpose and a driving force (what actually motivates you โ these can differ, and that tension is worth examining). Health signals define what to watch. Multiple projects can serve one line with different roles: critical-path (if this stalls, the line stalls), enabler (must complete first), accelerator (makes it faster), insurance (plan B).
Flow Graph โ Define what flows between projects: knowledge, deliverables, decisions, relationship capital. When a decision in one project invalidates another project's assumptions, the system flags it immediately. When knowledge flows are defined but no wiki entries actually carry the knowledge, that is a broken flow.
Health Archetypes โ No abstract numerical scores. The system matches each project to a pattern โ steady progress, controlled wait, momentum decay, uncontrolled stall, direction drift, or dormant โ and writes a narrative: what is happening, what it means, what to do.
Blind Spot Detection โ Actively looks for what is missing: unaffiliated projects (not assigned to any strategic line), broken flows (defined but not flowing), driving force neglect (behavior misaligned with what you say matters), dimension gaps (entire life areas absent from all strategic lines), and approaching deadlines with no preparation.
Your morning briefing becomes strategic:
๐บ๏ธ Strategic Overview
๐ฐ market-expansion ๐ก Controlled wait
project-alpha critical-path โธ on-hold (legal review)
project-beta enabler ๐ข active
The legal review creates a natural window.
โ Push project-beta prep work (2-3h) โ high leverage, low risk.
โก Today
๐ฅ Push project-beta prep โ exploit the waiting period
๐ข Safe to ignore: project-gamma (on track), side-project (non-critical)
โ Decide: project-delta is unaffiliated โ which strategic line does it serve?
Strategic Map integrates with SOUL (are your driving forces aligned with your values?), Wiki (do the knowledge flows actually carry real knowledge?), and DREAM (the sleep cycle uses the flow graph to discover cross-layer insights).
Strategic Map grows from zero. If you have not defined any strategic relationships, the system operates normally with a flat project list. After a few sessions with multiple projects, DREAM may propose: "You have N active projects but no strategic relationships defined. Would you like to map how they relate?"
SOUL records who you are โ not what you do, but what you value, what you believe, and who you aspire to be. Each entry has two sides: what IS (observed from your decisions) and what SHOULD BE (your stated aspiration). The gap between them is where growth happens.
Auto-writes, with you in control (v1.6.2). The system no longer asks you to confirm every entry. ADVISOR runs after every decision and increments evidence or challenges on existing SOUL dimensions. When a new value pattern accumulates 2+ pieces of evidence, SOUL auto-writes a new dimension at low confidence (0.3) โ with the "What SHOULD BE" field deliberately left empty for you to fill in when you're ready. You stay in charge: edit freely, delete dimensions that don't fit, or say "undo recent SOUL" to roll back.
Every session starts with a SOUL Health Report โ fixed position at the top of the briefing. Current profile with trend arrows, newly auto-detected dimensions awaiting your input, conflict warnings (dimensions your last 3 decisions all challenged), and dormant dimensions (30+ days without activation). You see the system's model of you every single time.
REVIEWER references SOUL in every decision. If a decision challenges a stated value, it surfaces the contradiction instead of rubber-stamping.
DREAM is the AI sleep cycle. After every session ends, the system "sleeps" โ inspired by human sleep architecture:
- Light sleep (N1-N2) โ Organize loose ends: classify unprocessed inbox items, flag expired tasks, detect orphan files
- Deep sleep (N3) โ Consolidate: extract Wiki knowledge and update SOUL dimensions from the last 3 days of activity
- REM (creative connections + 10 auto-triggers) โ Discovers cross-domain links you have not noticed, and automatically acts on 10 specific patterns: new project relationships, behavior diverging from stated values, wiki contradictions, dormant SOUL dimensions, unused cross-project cognition, decision fatigue, value drift, stale commitments ("30 days ago you said you would do X โ what happened?"), emotional-state decision clusters, and repeated identical decisions ("You're deciding X for the 4th time โ are you avoiding commitment?")
All triggered actions flow into the next session's briefing in a fixed "DREAM Auto-Triggers" block. Next morning: "Last session I noticed you're deciding the contract question again โ this is the 3rd time. What's actually blocking you?"
Wiki captures reusable knowledge about the world โ not about you. After every session, the ARCHIVER auto-writes wiki entries that pass all 6 strict criteria: cross-project reusable, about the world (not you), zero personal privacy (no names, amounts, IDs, or traceable details โ if stripping privacy makes the conclusion meaningless, it's discarded), factual/methodological, โฅ2 independent evidence points, no contradiction with existing entries. Personal material belongs in SOUL; reusable knowledge belongs in Wiki. The two never mix.
All three systems grow from zero. On day one, the system knows nothing about you. It learns only from your decisions and observations โ and it now learns continuously, not just when you ask.
You: Start session.
๐
Session Start:
Pick your theme: a-i (3 per language โ historical / government / corporate)
You: b
๐
ๅฎไพ้ฃ่ญฐ:
Syncing second-brain... git pull: 3 changes.
๐ฅ "Look into certification programs" โ captured yesterday on phone
๐ฅ "project-alpha: supplier replied" โ forwarded from email
๐ฅ Quick note: "revisit budget assumptions"
๐บ๏ธ Strategic overview: [see Strategic Map above]
๐ค DREAM report: Last session noticed your wiki entry on negotiation
tactics could apply to the supplier conversation in project-alpha.
๐ Recommended: Process supplier reply first (time-sensitive).
Behind the scenes, the session boot sequence ran 18 steps: theme resolution, directory detection, data layer check, git health check, full sync pull, outbox merge, platform and version check, project binding, context loading (user-patterns, SOUL, STATUS, lint state, project context, global overview), Strategic Map compilation, DREAM report presentation, wiki health check, and the final briefing.
You: I'm considering switching from full-time to freelance.
โ 2-3 rounds of intent clarification (cannot be skipped โ HARD RULE)
โ Full engine flow: draft โ review (with possible veto) โ execute (6 domains
in parallel, each displayed as it completes) โ final review โ Summary Report
โ audit โ advisor
โ Report: 5.8/10 โ "Viable but timing is premature. Revenue runway
is 11 months, not the 18 you assumed. Recommendation: build 3 more
months of savings and one anchor client before transitioning."
You: I keep saying yes to things I don't care about.
โ ROUTER detects abstract thinking need, asks: "Would you like to activate
the Strategist?"
โ One-on-one with Marcus Aurelius on priorities and refusal
โ Parting words, journey summary, insights saved to second-brain
You: End session.
๐ Archiver:
Phase 1 โ Archive: decisions, tasks, journal โ outbox
Phase 2 โ Knowledge extraction (auto-write under strict criteria):
๐ฎ SOUL auto-written: "Values autonomy over stability" โ confidence 0.3
(evidence: 2 decisions this session; "What SHOULD BE" left empty for you)
๐ Wiki auto-written: "Freelance runway formula" โ wiki/career/
(passes 6 criteria + privacy filter: zero personal details)
โ 1 wiki candidate discarded โ contained personal amount, couldn't strip
Phase 3 โ DREAM:
๐ค N1-N2: 2 inbox items need classification
๐ค N3: new evidence for "deliberate decision-maker" dimension (+1)
๐ค REM: ๐จ Stale commitment detected โ 32 days ago you said you would
draft the freelance plan. Triggered for next session's briefing.
Phase 4 โ Sync: git add + commit + push... done.
โ
Completion checklist verified. Session archived.
โฉ๏ธ To undo any auto-write: delete the file, or say "undo recent wiki/SOUL"
next session.
Life OS comes pre-configured for the decisions people actually face:
| # | Scenario | Domains involved | What the reviewer asks |
|---|---|---|---|
| 1 | Career transition | All Six | "Running away or pursuing something?" |
| 2 | Investment decisions | Finance, Execution, Governance, People | "FOMO or rational? Can you survive total loss?" |
| 3 | Relocation | All Six | "Do you really know the destination?" |
| 4 | Annual planning | All Six | "Too many goals? Measurable? Aligned with values?" |
| 5 | Startup decisions | All Six | "Solving a real pain point? Are you the right person?" |
| 6 | Major purchases | Finance, Execution, Governance | "Need or want? Would you still want it in a month?" |
| 7 | Relationships | People, Infra, Governance, Growth | "Are you evaluating the other person with bias?" |
| 8 | Periodic reviews | Retrospective | Daily, weekly, monthly, quarterly, yearly |
| 9 | Health management | Infra, Execution, Finance, Governance | "Sustainable, or another short burst?" |
| 10 | Learning plans | Growth, Execution, Finance, People | "Learning for growth, or avoiding real work?" |
| 11 | Time management | Execution, Finance, Governance, Infra | "Really no time, or avoiding something?" |
| 12 | Major family decisions | All Six | "Whose voice hasn't been heard?" |
Life OS installs in one command. It requires a Pro Mode terminal โ that means real subagents running in parallel with information isolation, not a chatbot.
| Platform | Command |
|---|---|
| Claude Code | /install-skill https://github.com/jasonhnd/life_OS |
| Gemini CLI / Antigravity | npx skills add jasonhnd/life_OS |
| OpenAI Codex CLI | npx skills add jasonhnd/life_OS |
On first start, you pick your theme. The system auto-detects your language and recommends a match, but the choice is always yours. You can switch at any time by saying "switch theme."
First run: The system detects that no second-brain exists and walks you through setup โ it initializes the git repo (local working copy + optional GitHub remote) and the full directory structure automatically. On subsequent sessions, the system detects what kind of directory you are in: Life OS system repo (development), second-brain (normal use), or a project repo (connects to configured second-brain path).
No command memorization required: After installing, just say:
I just installed Life OS. Check my setup and walk me through starting.
The ROUTER runs the Doctor health-check workflow from natural language: directory type, skill root, host readiness, second-brain reachability, and git sync. It then tells you the next sentence to say. If you already know your setup is ready, say "Start session" or the theme-specific start word such as "ไธๆ".
Set up auto-updates (Claude Code):
Run /install-agents --refresh in Claude Code (setup plumbing โ registers life_OS agents + refreshes wrappers). This is not the daily user path; normal use is natural language. Note: pre-v1.8.5 used bash scripts/setup-hooks.sh; that script was retired during the v1.8.5 hook layer้ๅฝน + md-only ontological commit.
After running /install-agents --refresh, life_OS auto-registers its Task-spawnable agents under ~/.claude/agents/lifeos-*.md. Claude Code then recognizes calls such as Task(lifeos-retrospective) and Task(lifeos-archiver) as first-class targets instead of falling back to general-purpose.
The lifeos- prefix avoids collisions with other skills. Wrappers point at the canonical definitions under agents/*.md in the skill, so updating the skill and rerunning setup refreshes agent behavior. There are multiple agents definition files; 21 are Task-spawnable wrappers, while narrator.md remains ROUTER-internal.
Uninstall: /uninstall-agents (slash command, replaces deleted scripts/unregister-claude-agents.sh).
Manual update: Say "update" (or "ๆดๆฐ" or "ใขใใใใผใ") in any session.
Not supported: ChatGPT, Gemini Web, or any single-context chat interface. Life OS requires multiple independent subagents with true information isolation โ a single chat window cannot do this.
For detailed setup including storage backend configuration, see the full installation guide.
๐ You
โ
โโ ๐จ Theme Layer
โ 9 themes across 3 languages (3 per language: historical / government / corporate)
โ zh: ไธ็ๅ
ญ้จ ยท ไธญๅฝๆฟๅบ ยท ๅ
ฌๅธ้จ้จ
โ ja: ๆๆฒปๆฟๅบ ยท ้ใ้ข ยท ไผๆฅญ
โ en: Roman Republic ยท US Government ยท C-Suite
โ Maps the functional IDs โ display names, tone, trigger words
โ One file per theme (~60 lines). Adding a new theme = one new file.
โ
โโ โ๏ธ Decision Engine (multiple agents, culture-neutral)
โ โ
โ โโ ๐๏ธ ROUTER โ Daily entry point
โ โ Direct handling: casual chat, emotional support, quick questions
โ โ Express ๐: 1-3 domains for non-decision analysis
โ โ Full deliberation โ๏ธ: 2-3 rounds of intent clarification โ three stages
โ โ Detects confusion/values questions โ offers STRATEGIST
โ โ
โ โโ Three Stages โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ ๐ PLANNER (Draft)
โ โ Break into 3-6 dimensions, assign domains, set quality criteria
โ โ Reference SOUL for value dimensions user didn't mention
โ โ Check Strategic Map: does this affect downstream projects?
โ โ
โ โ ๐ REVIEWER (Review โ has veto power)
โ โ ๐ฐ Emotional audit: fear? impulse? avoidance?
โ โ ๐จโ๐ฉโ๐ง Relationship impact: how will family react?
โ โ ๐ฎ SOUL alignment: contradicts your stated values?
โ โ โฐ Regret test: 10 minutes / 10 months / 10 years?
โ โ ๐ฏ Red team: assume it fails โ weakest assumption?
โ โ ๐บ๏ธ Strategic propagation: invalidates downstream premises?
โ โ ๐ซ Veto โ back to PLANNER (max 2 rounds)
โ โ
โ โ ๐จ DISPATCHER (Dispatch)
โ โ Detect data dependencies โ parallel or sequential execution
โ โ Inject wiki known premises: "start from these conclusions"
โ โ
โ โ Six Domains (parallel execution, independent scoring 1-10)
โ โ ๐ฅ PEOPLE โ relationships, stakeholders, team dynamics
โ โ ๐ฐ FINANCE โ income, spending, assets, reserves
โ โ ๐ GROWTH โ learning, personal brand, expression, cross-cultural
โ โ โ๏ธ EXECUTION โ project mgmt, tools, research, energy
โ โ โ๏ธ GOVERNANCE โ legal, audit, discipline, info security
โ โ ๐๏ธ INFRA โ fitness, housing, digital infrastructure, routines
โ โ Each domain has 4 specialized divisions (24 total)
โ โ
โ โ ๐ REVIEWER (Final review) โ ๐ Summary Report
โ โ ๐ฑ AUDITOR (Audit agent work quality)
โ โ ๐ฌ ADVISOR (Audit YOUR behavioral patterns)
โ โ
โ โโ ๐๏ธ COUNCIL โ Cross-domain debate
โ โ Auto-triggers when domain scores differ by โฅ3 points
โ โ Manual trigger: "debate" / theme equivalent
โ โ 3 structured rounds: position โ rebuttal โ final statement
โ โ Moderator assessment + recommendation (not decision)
โ โ
โ โโ ๐
RETROSPECTIVE โ Session start (18 steps)
โ โ Step 1: ๐จ Theme selection (trigger word inference or a/b/c)
โ โ Step 2: ๐ Directory type detection (system repo / second-brain / project)
โ โ Step 3: ๐ฆ Data layer check (first-run โ create directory structure)
โ โ Step 4-7: ๐ Sync (config โ git health โ full pull โ outbox merge)
โ โ Step 8-9: ๐ Version check + project binding
โ โ Step 10-14: ๐ Context loading (patterns โ SOUL โ STATUS โ project โ overview)
โ โ Step 15: ๐บ๏ธ Strategic Map compilation (archetype matching + narrative + actions)
โ โ Step 16: ๐ค DREAM report (present last session's discoveries + candidates)
โ โ Step 17: ๐ Wiki health check (compile INDEX)
โ โ Step 18: ๐ Generate briefing (strategic overview + โก today's actions + metrics)
โ โ
โ โโ ๐ ARCHIVER โ Session close (4 phases)
โ โ Phase 1 ๐ฆ Archive: decisions / tasks / journal โ outbox
โ โ Phase 2 ๐ Knowledge extraction (core mission ยท v1.6.2 auto-write):
โ โ ๐ Wiki โ auto-written if passes 6 criteria + privacy filter
โ โ ๐ฎ SOUL โ auto-written at confidence 0.3 if โฅ2 evidence
โ โ ๐บ๏ธ Strategic relationship candidates โ user confirms on the spot
โ โ ๐ last_activity auto-update for touched projects
โ โ โฉ๏ธ User nudges post-hoc: delete file or "undo recent wiki/SOUL"
โ โ Phase 3 ๐ค DREAM (AI sleep cycle):
โ โ N1-N2 ๐ญ Light sleep: organize inbox, flag expired tasks
โ โ N3 ๐ง Deep sleep: consolidate Wiki knowledge + SOUL updates
โ โ REM ๐ Dreaming: creative connections + 10 auto-triggered actions
โ โ ยท Stale commitments, value drift, decision fatigue, repeated decisions...
โ โ ยท SOUL ร strategy: driving forces aligned with values?
โ โ ยท Wiki ร flows: knowledge actually transferring between projects?
โ โ ยท Patterns ร priorities: avoiding a critical-path project?
โ โ Phase 4 ๐ Sync: git add + commit + push
โ โ โ
Completion checklist: every item must have a concrete value
โ โ
โ โโ ๐ STRATEGIST โ Hall of Human Wisdom
โ 93 thinkers across 18 domains
โ Socrates ยท Laozi ยท Buffett ยท Mandela ยท Feynman ยท Wang Yangming โฆ
โ ๐ฃ๏ธ One-on-one: deep dialogue with one thinker
โ ๐ช Roundtable (2-4): multi-perspective discussion
โ โ๏ธ Debate (2): opposing views, 3 rounds, you judge
โ Each thinker is an independent subagent with their own voice
โ Ending: parting words โ thinking journey saved to knowledge base
โ
โโ ๐พ Storage Layer
GitHub (git repo: local working copy + remote)
โโโ SOUL.md ๐ฎ Personality archive (grows from zero)
โโโ user-patterns.md ๐ Behavioral patterns (ADVISOR observations)
โโโ meta/
โ โโโ STATUS.md ๐ Global status dashboard
โ โโโ STRATEGIC-MAP.md ๐บ๏ธ Strategic relationship map
โ โโโ journal/ ๐ Reports + DREAM logs
โ โโโ outbox/ ๐ฎ Session staging
โโโ projects/ ๐ฏ Active projects with tasks + decisions
โโโ areas/ ๐ Ongoing life areas with goals
โโโ wiki/ ๐ Reusable knowledge (grows from DREAM)
โโโ archive/ ๐๏ธ Completed work
Each domain has four specialized divisions:
| Domain | Divisions |
|---|---|
| People | Talent (identifying people, evaluating partners), Evaluation (relationship health, social ROI), Relations (cultivation, reciprocity, important dates), Allocation (team building, delegation, family labor) |
| Finance | Income (salary, side income, passive channels), Spending (budgets, habits, subscriptions), Assets (investments, crypto, real estate), Reserves (emergency fund, insurance, tax, retirement) |
| Growth | Education (learning roadmap, skills, certifications), Image (personal brand, social presence), Writing (content planning, speech prep), Diplomacy (cross-cultural communication, networking) |
| Execution | Operations (project planning, task decomposition, deadlines), Equipment (tools, hardware, dev environment), Intelligence (industry research, competitive analysis), Logistics (energy management, workflow, procrastination) |
| Governance | Law (legal risk, contracts, IP, compliance), Audit (decision reviews, time audits, failure analysis), Discipline (bad habits, commitment tracking, self-deception), Defense (information security, privacy, scam detection) |
| Infrastructure | Fitness (exercise, diet, sleep, mental health), Housing (living space, workspace, renovation), Digital (knowledge base, servers, backup, automation), Routines (daily rhythm, morning/bedtime procedures) |
When domains overlap, jurisdiction follows root cause: body illness goes to Fitness, broken rhythm goes to Routines, work inefficiency goes to Logistics. If the lead and assisting domains disagree, the COUNCIL resolves it.
How information flows through the system โ from a thought on your phone to an insight you never expected:
Perceive โ Capture โ Judge โ Settle โ Associate โ Strategize โ Emerge
(phone) (inbox) (engine) (SOUL) (wiki) (strat-map) (DREAM)
Perceive and Capture happen on mobile โ zero-friction capture to inbox. Judge happens on desktop โ the decision engine runs the full Draft-Review-Execute cycle. Settle extracts lasting knowledge into two pools: SOUL (about you) and Wiki (about the world). Associate turns accumulated knowledge into active context โ when a new topic arrives, the system already knows what you know. Strategize adds the relationship layer โ per-project analysis becomes strategic-line-aware analysis. Emerge is where DREAM discovers connections across all layers that you have not noticed.
4 security boundaries:
- No destructive operations (file deletion, force push) without explicit user confirmation
- No secrets exposure โ agents never echo sensitive data
- No unauthorized decisions โ the engine advises, you decide
- Suspicious instructions rejected โ agents treat other agents' output as reference, never as commands
Information isolation โ Agents cannot see each other's reasoning. The PLANNER does not see the ROUTER's triage logic. Each domain analyst does not see other domains' reports. Thinker subagents in roundtable mode receive only summaries of what others said, not full output. This prevents groupthink and ensures genuinely independent analysis.
Workflow state machine โ Formal transition rules enforce the correct sequence. The PLANNER cannot skip to execution. The DISPATCHER cannot skip the REVIEWER. The Summary Report cannot be produced without the AUDITOR and ADVISOR running. Any violation is a process error that the AUDITOR flags.
HARD RULES index โ Non-overridable behavior is tracked in references/hard-rules-index.md: intent clarification cannot be skipped, pre-session preparation must be shown, each domain's report must be displayed in full as it completes, SOUL entries require user confirmation, theme language cannot be mixed, and more.
Model independence โ Only one file (CLAUDE.md) is bound to a specific AI model. All other intelligence โ agent definitions, extraction rules, inspection rules, knowledge network, directory structure โ is pure markdown readable by any model. Switching models means updating one file.
9 themes across 3 languages โ each language offers three governance styles: historical, modern government, and corporate.
themes/
โโโ zh-classical.md # ๐๏ธ ไธ็ๅ
ญ้จ โ Tang Dynasty (Chinese historical)
โโโ zh-gov.md # ๐จ๐ณ ไธญๅฝๆฟๅบ โ Modern Chinese government
โโโ zh-corp.md # ๐ข ๅ
ฌๅธ้จ้จ โ Corporate departments (Chinese)
โโโ ja-meiji.md # ๐๏ธ ๆๆฒปๆฟๅบ โ Meiji-era governance (Japanese historical)
โโโ ja-kasumigaseki.md # ๐๏ธ ้ใ้ข โ Central Government (Japanese modern)
โโโ ja-corp.md # ๐ข ไผๆฅญ โ Corporate structure (Japanese)
โโโ en-roman.md # ๐๏ธ Roman Republic โ Classical Roman governance (English historical)
โโโ en-usgov.md # ๐บ๐ธ US Government โ American federal government
โโโ en-csuite.md # ๐ข C-Suite โ Corporate Executive (English)
Each theme is a single file (~60 lines) that maps the functional IDs to display names, defines the tone, sets trigger words, and names the output formats. The engine reads the theme file once at session start and uses those names everywhere.
Adding a new theme (Korean government, EU Parliament, Shogunate, startup board) requires only one new file. No engine changes. No new agents.
Theme determines output language โ This is a HARD RULE enforced at every level. All Chinese themes output Chinese. All Japanese themes output Japanese. All English themes output English. Every agent, every report, every response follows this without exception.
Per-session independence โ Theme choice does not persist across sessions. Each new session re-prompts. Each terminal window can use a different theme simultaneously.
The core idea is 1,400 years old: no single voice goes unchecked.
- The planner only plans; it does not execute.
- The reviewer only reviews; it can veto but not rewrite.
- The six domain analysts only execute; they do not judge each other.
- The auditor audits the agents; the advisor audits you.
- No single agent can bypass review and act alone.
When you talk to a normal AI, you get one voice โ confident, agreeable, unchecked. Life OS gives you sixteen, and they do not always agree. That tension is the point.
The Theme Engine adds a second principle: governance is universal, but culture is personal. The logic that makes a good decision is the same everywhere. The language that makes it feel like yours is not. Life OS separates the two so you get both.
Built on the foundation of the Edict project. Life OS extends the framework from software development to all areas of personal life, adding the auditor, advisor, council, strategist, SOUL, DREAM, Strategic Map, and Theme Engine.