Keel · Guides · Getting started

How Keel fits together

What are all these things?

A routine is what you take and when; Keel turns it into scheduled doses, logging writes a record, a program groups routines, and a supply profile is a vial that logged doses draw down.

AvailabilityFree

Written for Keel 1.0.0 · build 1Content 2026.09.14 · 2026.09.16-batch1Screens from working tree 7e41269 (NOT a candidate) and build 1 (4cbadaa)

A routine is what you take and when. Keel turns it into scheduled doses — one row per planned time on Today and the calendar. Logging a dose writes a record of what you actually did, at the time you say. A program groups routines into one block with its own timeline. A supply profile is a vial or stock that logged doses draw down. Everything in them is information you entered or accepted (a default such as the 9:00 AM start time) plus what Keel derives from it — dose times and the DUE / LATE / MISSED labels.

Routine

Created from + › New routine: a name, a Category, an Administration, Repeats, times or Any time of day, Duration, and an optional Dose kept "without interpretation — Keel never suggests amounts." Existing routines live under + › Manage routines, on a sheet titled Routines.

Scheduled dose

For each planned time Keel keeps one dose row: the time on the left, the circle mark, the name, and a grey dose · site line. A pending timed dose is Upcoming, then DUE for its first hour, LATE until 24 hours have passed, then MISSED; a pending any-time dose stays DUE all day, never Late. The word appears under the time only when it is not Upcoming or Done.

Record

Tapping the mark, Log done, or Log at a time… writes a log with a Taken at time; on time or late is judged from that time — a timed dose against its planned or Move time (a snooze is ignored), an any-time dose by calendar day: the same or an earlier day is Done, a later day Late. A skip is a record too. Records are history: Edit log adds a corrected version and Undo adds a reversal — nothing is overwritten or deleted.

Program

+ › New program groups routines you already track "into one block with its own timeline and history." Free runs one active program at a time; Pro runs programs side by side.

Supply profile

Tools › Vials & Inventory (Pro — on Free the row carries a Pro mark and opens the membership sheet): "Compatible logged doses draw down attached supply."

Tabs

Today, Calendar, the centre + (the create menu, not a tab), Insights, Tools; the gear on Today opens Settings.

Today screen with the greeting and Tue, Sep 16 eyebrow, an Overdue readout, groups labelled Overdue, Now and Later with dose rows, an accent needle line, and a bottom bar with Today, Calendar, a plus button, Insights and Tools. — Fictional day: Today’s header states the leading fact; scheduled doses sit in groups by state; the bar holds the four tabs and the create button.
header readout (Overdue eyebrow)
Overdue group
Now group
NOW needle
Later group
tab bar with the centre +
Where this screen comes from
File
`B1-F1-today-groups.png` (1320×2580); `B1-F1-today-groups.webp` is a lossy encode of it
Derivative SHA-256
`3227c0fa6872651f71732cc7cc9d9edd5d497379205b9e8e7ec28ad3efffe741`
Source
`B1-F1.png` in package `Keel-WT-7e41269-guide-figures-B1-20260924-090933-67253`
Source SHA-256
`095be0e7920b961281d0cf84c5156b09e2b540a54f1bc7166901c460c2428264`
Package seal
`fd002ec92b03ee746be00143a4397ff542b7ef280c610dfb07bdf49a1ff4efc5`
Captured from
Keel 1.0.0 (1), implementation `working tree 7e41269 (NOT a candidate; head 7e4126919da3a44a9ad2f2efaf3ad2467c1fbff7, build-input tree 213aa887926d08f17538a5789db46f99fbc9a8120019b2cd3c59876621f68970, build build-20260917-181010-73820)`
Operation
crop x0 y186 w1320 h2580 (source pixels, origin top-left)
The numbered markers are drawn by the page, not into the image.

The Tools list showing a Tracking section with Routines & Programs and Vials & Inventory marked Pro, and calculator rows above. — Tools on Free: routines and programs are managed here; Vials & Inventory carries the Pro mark and is readable in this guide either way.
Routines & Programs
Vials & Inventory with its Pro mark
Where this screen comes from
File
`G3-F1-tools-pro-marks.png` (1320×1085); `G3-F1-tools-pro-marks.webp` is a lossy encode of it
Derivative SHA-256
`a8287bbcc3ff93766ce3a259c1b061c423ef09da9316b6a3039773fdd07551ef`
Source
`EV-021_tools-s1-standard-light-gates.png (promax/current)` in package `Keel-V1-4cbadaa-signoff`
Source SHA-256
`ec28e83360f67bc6bfad95621ab732d129fa2048fe65a6cf5260020fca3e2d1a`
Package seal
`65268f2b78728fbf82ba56a02668a2400276c526627da043627276887510b5b3`
Captured from
Keel 1.0.0 (1), implementation `4cbadaa1c63a0678b61e703583fadc9af226267d` (reused-unchanged)
Operation
crop x0 y1360 w1320 h1085 (source pixels, origin top-left)
The numbered markers are drawn by the page, not into the image. Full provenance.

This guide names Keel’s parts; it never says what a routine should contain, how much a dose should be, or when to take anything.