Skip to main content

A TOML based scheduling tool

Project description

Schedule Everything

Logic Tests CLI Tests PyPI version License: MIT Documentation Ask DeepWiki 中文版本

AI-assisted time management for people who want a schedule that is easy to use, local-first, and grounded in healthier defaults instead of pure calendar spam.

rmd setup is profile-first: it creates or refines profile.md, asks follow-up questions, summarizes the plan, and only then writes the schedule. rmd sync takes your current tasks and turns today's pomodoro/potato blocks into concrete work items with a preview-before-save loop. rmd is now the primary CLI name; reminder is still shipped as a legacy alias.

Why This Exists

Most productivity tools are good at filling time and bad at protecting energy. Schedule Everything is built around a different assumption: good time management should be easier, more personalized, and more scientifically informed.

When your preferences are incomplete, the planner leans on evidence-informed defaults that try to protect:

  • enough sleep opportunity instead of routinely cutting sleep for more work
  • regular sleep timing instead of large weekday/weekend swings
  • consistent movement and exercise across the week
  • short recovery breaks during long desk-bound stretches
  • earlier placement of demanding work when daylight and flexibility allow

These are heuristics, not medical advice. Real constraints, clinician guidance, shift work, disability needs, and caregiving realities should override them.

Selected sources:

  • Watson NF, Badr MS, Belenky G, et al. Recommended Amount of Sleep for a Healthy Adult. AASM consensus PDF
  • Sletten TL, Weaver MD, Foster RG, et al. The importance of sleep regularity. Sleep Health, 2023
  • World Health Organization. Physical activity recommendations for adults. WHO guidance
  • Albulescu P, Macsinga I, Rusu A, et al. "Give me a break!" PLOS ONE, 2022
  • Figueiro MG, Steverson B, Heerwagen J, et al. The impact of daytime light exposures on sleep and mood in office workers. Sleep Health, 2017

Why It Feels Easy

  • profile.md stores durable context about how you work, not just what time blocks exist.
  • rmd setup asks normal-language questions instead of forcing you to hand-author a calendar first.
  • rmd sync converts tasks.json into titled focus blocks and asks for approval before writing anything.
  • The system stays local: TOML files, JSON task data, and a small CLI instead of a cloud dashboard.
  • You can still inspect and edit everything manually because the generated files are plain text.

Quick Start

1. Install

git clone --recurse-submodules https://github.com/sergiudm/schedule-everything.git
cd schedule-everything
./install.sh
./third_party/opencode/install --no-modify-path

2. Build Your Schedule with AI

rmd setup

This stores model settings in ~/.schedule_management/llm.toml, builds or updates profile.md, and generates your schedule only after showing you a summary first.

3. Add Tasks and Sync Today

rmd add "Finish proposal draft" 9
rmd add "Review PR #128" 7
rmd sync

rmd sync reads tasks/tasks.json, proposes task assignments for today's pomodoro/potato blocks, and regenerates if you reject the preview with feedback.

4. Check the Result

rmd status
rmd status -v
rmd view
rmd update

When a sync overlay exists for today, rmd status shows the block type and the specific assigned event, for example pomodoro: Finish proposal draft.

Core Commands

Command What it does
rmd setup Build or modify your schedule with a profile-first AI workflow
rmd sync Assign today's pomodoro/potato blocks to tasks with preview + approval
rmd status [-v] Show what is happening now and today's schedule, including synced titles
rmd add/ls/rm Manage the task list that feeds the sync flow
rmd track Record habits
rmd ddl Manage deadlines
rmd view Generate a PDF schedule visualization

Manual Setup and Docs

The low-level manual configuration flow has been moved to the docs.

License

Distributed under the MIT License. See LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

schedule_management-0.7.5.tar.gz (104.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

schedule_management-0.7.5-py3-none-any.whl (99.1 kB view details)

Uploaded Python 3

File details

Details for the file schedule_management-0.7.5.tar.gz.

File metadata

  • Download URL: schedule_management-0.7.5.tar.gz
  • Upload date:
  • Size: 104.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for schedule_management-0.7.5.tar.gz
Algorithm Hash digest
SHA256 2415fcaa195ed99e04773f02cfa4e1ef0965ba43f4ee214d49619e38baa41307
MD5 9512f90883749ca7b3a6292b550ff792
BLAKE2b-256 800c9bd1fecc840eb508563d8ba2bc443745ecb8aa0f58aec2daa90481c16fbf

See more details on using hashes here.

File details

Details for the file schedule_management-0.7.5-py3-none-any.whl.

File metadata

File hashes

Hashes for schedule_management-0.7.5-py3-none-any.whl
Algorithm Hash digest
SHA256 1d77faba2cfa463de4c30a5778cfa95878fa87bae0ad0afa63183738003ee755
MD5 396d2c67221234b1e48bdecbba990834
BLAKE2b-256 755e6fa15d9576b5c86905244d910f8d3c49e59d0a9af0249696ab87e12637cb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page