reminders-tui

A terminal UI for Apple Reminders, built with Bubble Tea and Lip Gloss.

Shells out to remindctl for all data access -- no CGo, no direct EventKit.

Install

go install github.com/nodeselector/reminders-tui@latest

Or build from source:

go build -o reminders-tui .

Requires remindctl in ~/.local/bin/ or on your PATH.

Views

Key	View	Description
1	Today	Due today + overdue, grouped
2	Upcoming	Next 7 days, grouped by date
3	Lists	Grouped by list name
4	All	Flat list, sorted by urgency

Keybinds

Key	Action
j / k	Navigate down / up
x / Space	Complete reminder
a	Add new reminder
e	Edit selected reminder
d	Delete (with confirmation)
Tab / 1-4	Switch views
/	Search / filter
r	Refresh data
?	Help overlay
q	Quit

Architecture

main.go                  -- entry point
internal/
  remindctl/             -- CLI wrapper (exec + JSON parse)
    remindctl.go
    remindctl_test.go
  model/                 -- Bubble Tea model, update, view
    model.go
    keys.go
  ui/                    -- styles, formatting helpers
    styles.go
    format.go
    format_test.go

Testing

go test ./...