lifeos-cli 0.9.0

Command-line tooling for personal operating system workflows, tools, and automation.

lifeos-cli

Simplified Chinese: README.zh-Hans.md

lifeos-cli is a CLI-first LifeOS for self-managing super individuals: human-friendly in direct use, agent-friendly in automation, and built to hold the structured digital life data that connects intention with reality.

Value Proposition

Most personal systems fragment life into disconnected tools. That makes it unnecessarily hard to understand:

• What did I intend to do?
• What actually happened?
• Where did my time and energy really go?
• Which relationships, routines, and priorities am I actually living out?

lifeos-cli treats those questions as one system problem. It gives structure to both sides of life:

• intention: visions, tasks, habits, and planned events
• reality: notes, timelogs, completed habit actions, and relationship records

The goal is not just to store personal data, but to make self-management, reflection, and automation operate on the same durable source of truth.

Why CLI

The CLI is the shared interface. People can use it directly, and existing agents can call the same commands without needing a separate embedded agent layer.

Current Scope

The current system already covers the core building blocks of a LifeOS:

• notes
• areas
• tags
• people
• visions
• tasks
• habits and habit actions
• events
• timelogs

These modules already cover what matters, what is planned, what is being executed, and what actually happened.

Getting Started

Install from PyPI:

uv tool install lifeos-cli

Initialize your local setup:

lifeos init

See the available command surface:

lifeos --help

For complete CLI usage, workflows, and output conventions, see docs/cli.md.

Development

1. Install uv.

2. Sync the development environment:

   uv sync --all-extras
   

3. Run the default validation entrypoint:

   bash ./scripts/doctor.sh
   

   This baseline includes linting, dead-code scanning, and the default non-integration test suite.

4. Run the real CLI integration suite explicitly when you have a PostgreSQL test database:

   LIFEOS_RUN_INTEGRATION=1 \
   LIFEOS_TEST_DATABASE_URL=postgresql+psycopg://postgres:<password>@127.0.0.1:5432/lifeos_test \
   bash ./scripts/integration_tests.sh
   

5. Use the repository dependency workflows intentionally:

   • .github/dependabot.yml opens a single weekly grouped version-update PR for uv.
   • bash ./scripts/dependency_health.sh remains the explicit maintainer audit flow for outdated packages and dev vulnerability review.

CI also runs the real CLI integration suite against an ephemeral PostgreSQL service through the same dedicated integration entrypoint.

Project Policies

• Contribution workflow: CONTRIBUTING.md
• Security disclosure: SECURITY.md
• Community expectations: CODE_OF_CONDUCT.md

License

This project is licensed under the Apache License 2.0. See LICENSE.