Skip to content

BearGare/LifeOS

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

639 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

LifeOS

The Life Operating System

Release Algorithm Stars License

Watch the walkthrough Β· Releases Β· Docs


LifeOS is a Life Operating System. It captures who you are, what you care about, and where you're trying to go, then uses AI that knows you to help you get there. Everything runs on one loop: move from your current state to your ideal state through steps you can verify.

Install

Give it to your AI. Paste this into Claude Code (or any AI coding harness) and say "install this" β€” your AI does the whole setup for you.

curl -fsSL https://ourlifeos.ai/install.sh | bash

Prefer the terminal? Run the same command yourself. You'll need Claude Code and bun.

Core Components

The unique features β€” the parts you won't find anywhere else.

🎯

Current β†’ Ideal State

Name where you are and where you want to be, then close the gap with checkable steps.

πŸ“ˆ

General Hill Climbing

Every goal becomes a hill; the system keeps picking the next move that closes the gap.

🧭

TELOS

Your mission, goals, and challenges. LifeOS interviews you to capture them, then reasons against them.

βš™οΈ

The Algorithm

A seven-phase engine that turns a vague ask into a testable spec and climbs toward it.

πŸ“‹

The ISA

The Ideal State Artifact β€” one document capturing what "done" is, as verifiable criteria.

🧩

The Skill System

100+ self-activating, composable units of expertise.

πŸͺ

The Hook System

Guardrails that are code, not good intentions, enforced every session.

πŸ”€

The Router System

Every prompt routed to the right effort and model, automatically.

πŸ“Š

Pulse

The Life Dashboard β€” where you watch the whole system run.

✨

Custom Spinner Verbs

Your own animated working-verb and tips in the statusline.

πŸ’¬

Custom Tooltips

The dashboard explains itself on hover, no manual needed.

The supporting components β€” the subsystems underneath.

🧠 Memory
Compounds across sessions.
πŸ€– Agents
Parallel delegation to specialists.
πŸ”Š Voice
Spoken notifications in your voice.
πŸŽ“ Learning
Every run feeds the next.
πŸ›‘οΈ Security
Keeps private data private.

🧩 Skills

LifeOS installs as one self-contained skill that bundles the whole library β€” research, security, writing, art, and more. Browse them all on the site.

Browse all skills β†’


❓ FAQ

How is LifeOS different from just using Claude Code?

LifeOS is built natively on Claude Code and designed to stay that way. We chose Claude Code because its hook system, context management, and agentic architecture are the best foundation available for personal AI infrastructure.

LifeOS isn't a replacement for Claude Code β€” it's the layer on top that makes Claude Code yours:

  • Persistent memory β€” Your DA remembers past sessions, decisions, and learnings
  • Custom skills β€” Specialized capabilities for the things you do most
  • Your context β€” Goals, contacts, preferencesβ€”all available without re-explaining
  • Intelligent routing β€” Say "research this" and the right workflow triggers automatically
  • Self-improvement β€” The system modifies itself based on what it learns

Think of it this way: Claude Code is the engine. LifeOS is everything else that makes it your car.

What's the difference between LifeOS and Claude Code's built-in features?

Claude Code provides powerful primitives β€” hooks, slash commands, MCP servers, context files. These are individual building blocks.

LifeOS is the complete system built on those primitives. It connects everything together: your goals inform your skills, your skills generate memory, your memory improves future responses. LifeOS turns Claude Code's building blocks into a coherent personal AI platform.

Is LifeOS only for Claude Code?

LifeOS is Claude Code native. We believe Claude Code's hook system, context management, and agentic capabilities make it the best platform for personal AI infrastructure, and LifeOS is designed to take full advantage of those features.

That said, LifeOS's concepts (skills, memory, algorithms) are universal, and the code is TypeScript and Bash β€” so community members are welcome to adapt it for other platforms.

How is this different from fabric?

Fabric is a collection of AI prompts (patterns) for specific tasks. It's focused on what to ask AI.

LifeOS is infrastructure for how your DA operatesβ€”memory, skills, routing, context, self-improvement. They're complementary. Many LifeOS users integrate Fabric patterns into their skills.

What if I break something?

Recovery is straightforward:

  • Back up first β€” Before any upgrade: cp -r ~/.claude ~/.claude-backup-$(date +%Y%m%d)
  • USER/ is safe β€” Your customizations in USER/ are never touched by the installer or upgrades
  • Settings merge, not overwrite β€” The installer only updates identity and version fields; your hooks, statusline, and custom config are preserved
  • Git-backed β€” Version control everything, roll back when needed
  • History is preserved β€” Your DA's memory survives mistakes
  • DA can fix it β€” Your DA helped build it, it can help repair it
  • Re-install β€” Run the installer again; it detects existing installations and merges intelligently

🎯 Roadmap

Feature Description
Local Model Support Run LifeOS with local models (Ollama, llama.cpp) for privacy and cost control
Granular Model Routing Route different tasks to different models based on complexity
Remote Access Access your LifeOS from anywhereβ€”mobile, web, other devices
Outbound Phone Calling Voice capabilities for outbound calls
External Notifications Robust notification system for Email, Discord, Telegram, Slack

🌐 Community

GitHub Discussions: Join the conversation

Community Discord: LifeOS is discussed in the community Discord along with other AI projects

Twitter/X: @danielmiessler

Blog: danielmiessler.com

Star History

Star History Chart

🀝 Contributing

We welcome contributions! See our GitHub Issues for open tasks.

  1. Fork the repository
  2. Make your changes β€” Bug fixes, new skills, documentation improvements
  3. Test thoroughly β€” Install in a fresh system to verify
  4. Submit a PR with examples and testing evidence

πŸ“œ License

MIT License - see LICENSE for details.


πŸ™ Credits

Anthropic and the Claude Code team β€” First and foremost. You are moving AI further and faster than anyone right now. Claude Code is the foundation that makes all of this possible.

IndyDevDan β€” For great videos on meta-prompting and custom agents that have inspired parts of LifeOS.

Contributors

fayerman-source β€” Google Cloud TTS provider integration and Linux audio support for the voice system.

Matt Espinoza β€” Extensive testing, ideas, and feedback, plus roadmap contributions.


πŸ’œ Support This Project

Sponsor

LifeOS is free and open-source forever. If you find it valuable, you can sponsor the project.


πŸ“š Related Reading


πŸ“œ Update History

v6.0.0 (2026-07-02) β€” One Skill, One Install

  • Skill-based distribution β€” the whole system now ships as a single self-contained skill (LifeOS/): the orchestrator (SKILL.md + Workflows + Tools) plus a complete install payload (system prompt, Algorithm, 49 skills, hooks, agents, Pulse, statusline, USER + MEMORY scaffolds). One directory, one install.
  • First release under the LifeOS name β€” the project was PAI (Personal AI Infrastructure); this is the same system, renamed.
  • One-line install β€” curl -fsSL https://ourlifeos.ai/install.sh | bash lays down the entire system.
  • Full Pulse on first boot β€” the installer stands up the Life Dashboard and menu-bar app, ships generic TELOS templates so the dashboard renders on a fresh install, and runs the setup interview to seed it.
  • Algorithm v6.23.0 β€” Current State β†’ Ideal State across seven phases, classifier-driven mode + tier, cross-vendor verification at E4/E5.
  • Clean by construction β€” nothing personal ships; the USER tree is a blank template you populate. Release gates + a cross-vendor audit run before every publish.
  • Full release notes

v5.0.0 (2026-04-30) β€” Life Operating System

  • Pulse β€” unified daemon (port 31337): voice, hooks, observability, cron, Life Dashboard, wiki API, optional Telegram/iMessage bridges. Replaces every previous loose service.
  • The DA β€” Digital Assistant identity layer. PRINCIPAL_IDENTITY + DA_IDENTITY pair, loaded at session start. /interview walks you through naming your DA, picking a voice, capturing TELOS.
  • Algorithm v6.3.0 β€” seven-phase loop (OBSERVE β†’ THINK β†’ PLAN β†’ BUILD β†’ EXECUTE β†’ VERIFY β†’ LEARN). Classifier picks MINIMAL/NATIVE/ALGORITHM and tier (E1–E5) per prompt. Verification doctrine (live-probe, advisor calls, cross-vendor audit at E4/E5).
  • The ISA β€” Ideal State Artifact primitive. One document, twelve sections, five identities. Owned by the ISA skill.
  • Containment + release tooling β€” privacy is structural. Security gates run on every public release; two-stage release (stage β†’ publish) never auto-chains.
  • Memory v7.6 β€” structured by purpose: WORK, KNOWLEDGE (typed graph), LEARNING, RELATIONSHIP, OBSERVABILITY, STATE.
  • Full release notes + migration guide

v4.0.3 (2026-03-01) β€” Community PR Patch

  • JSON array parsing fix in Inference.ts, 29 dead references removed, portability fixes, user context migration
  • Release Notes

v4.0.0 (2026-02-27) β€” Lean and Mean

  • 38 flat skill directories β†’ 12 hierarchical categories, dead systems removed, CLAUDE.md template system, comprehensive security sanitization
  • Release Notes

v3.0.0 (2026-02-15) β€” The Algorithm Matures

  • Algorithm v1.4.0, persistent PRDs and parallel loop execution, full installer with GUI wizard, agent teams/swarm, voice personality system
  • Release Notes

v2.4.0 (2026-01-23) β€” The Algorithm

  • Universal problem-solving system with ISC tracking, Euphoric Surprise as the outcome metric
  • Release Notes

v2.0.0 (2025-12-28) β€” v2 Launch

  • Modular architecture with independent skills, Claude Code native design

Built with ❀️ by Daniel Miessler and the LifeOS community

Augment yourself.

About

Agentic AI Infrastructure for magnifying HUMAN capabilities.

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 79.9%
  • Python 6.0%
  • Shell 4.0%
  • CSS 2.6%
  • HTML 2.4%
  • Vue 2.1%
  • Other 3.0%