nag

A LazyGit-style terminal UI for Apple Reminders. Browse lists, view reminders, create, complete, and delete — all from the terminal.

Features

• Two-panel layout — lists sidebar + reminders
• Smart lists — Today (includes overdue) and Scheduled views
• Vim-style navigation — j/k, g/G, Ctrl-d/Ctrl-u
• Create reminders — title, due date with time, priority
• Complete/uncomplete — toggle with Space, 2s grace period to undo
• Delete — with confirmation prompt
• Open in Reminders — jump to the reminder in Apple Reminders
• Sort — cycle between default, created, due date, and title with s
• Show/hide completed — toggle visibility with c
• Auto-refresh — polls every 10 seconds for external changes
• Filter/search — fuzzy search across titles and notes
• Mouse support — click to focus panels, scroll to navigate

Install

Homebrew (recommended)

brew install oronbz/tap/nag

Go install

Requires Go 1.25+ and macOS (uses native EventKit via cgo):

go install github.com/oronbz/nag@latest

From source

git clone https://github.com/oronbz/nag.git
cd nag
make install

Usage

nag

On first run, macOS will prompt for Reminders access. You can manage this in System Settings > Privacy & Security > Reminders.

Key Bindings

Navigation

Key	Action
j / k, ↑ / ↓	Navigate
Enter	Select list
Tab / Shift-Tab	Switch panel
g / G	Jump to top / bottom
Ctrl-d / Ctrl-u	Page down / page up
/	Filter / search
Left click	Focus panel
Mouse wheel	Scroll

Actions

Key	Action
Space / x	Toggle reminder complete
n	New reminder / list
e	Edit reminder / list
d	Delete reminder / list
o	Open in Apple Reminders
s	Cycle sort order
c	Toggle show completed
r	Refresh

General

Key	Action
?	Toggle help overlay
Esc	Close dialog / overlay
q / Ctrl-C	Quit

Layout

┌──────────┬─────────────────────┐
│  Lists   │     Reminders       │
│          │                     │
│ ◉ Today  │ ☐ Buy groceries !!! │
│ ▦ Sched. │   today  Get milk.. │
│ ───────  │ ☑ Call dentist      │
│ Personal │   yesterday         │
│ Work     │                     │
└──────────┴─────────────────────┘
 status bar

Built With

• go-eventkit — Native macOS EventKit bindings (cgo)
• Bubble Tea — TUI framework (Elm Architecture)
• Lip Gloss — Styling and layout
• Bubbles — TUI components (list, viewport, textinput, spinner)

License

MIT