Documentation

Status: Early development — features and commands may change. Developer: David Cody.

Introduction

Chronos Engine is an intelligent life management system. It lets you compose your life as a hierarchy of items and uses a status‑aware scheduler to build optimal daily plans.

Core Concepts

• Items: Atomic units like task, note, goal, routine, and more. Stored as YAML.
• Fractal Structure: Templates nest logically (week → day → routine → subroutine → microroutine).
• User Status: Variables like emotion, energy, and focus guide the scheduler.
• Templates: Reusable blueprints for days, weeks, and routines.
• Reminders: Time‑based notifications handled by the Listener module.

Today Scheduler

The today command is the daily driver.

• today: Loads and displays the persisted schedule for today.
• today reschedule: Regenerates today’s schedule, applies manual edits, resolves conflicts (shift/trim/cut), and saves the result.

Status

Set your status to inform scheduling decisions. Example: status energy:high focus:good. Chronos can widen buffers, reduce high‑energy tasks, or prioritize critical items based on these values.

Data Model

Everything is YAML. Items live in the User/ directory. Templates reference sub‑items to form a navigable graph (e.g., a Day template references Routine items, which reference Subroutines, and so on).

Dashboard

The dashboard command opens a web dashboard for a quick, visual overview of time, notes, status, and today’s schedule. It complements the CLI-focused workflow.

Philosophy

Chronos favors clarity, portability, and automation: human‑readable files, smart scheduling, and a concise CLI. Keep your system simple; iterate with templates; trust the engine’s context to fill in gaps.