pi-todo

A pi extension that gives you a to-do list synced with Apple Reminders. The AI can manage your todos via a tool, and you can browse and edit them in an interactive TUI — all changes sync to and from the "pi" list in Apple Reminders.

Installation

pi install npm:@patriceckhart/pi-todo

That's it. The extension is auto-discovered on next start or /reload.

Other options

# Try it without installing
pi -e npm:@patriceckhart/pi-todo

# Install from git
pi install https://github.com/patriceckhart/pi-todo

# Local development
ln -s /path/to/pi-todo ~/.pi/agent/extensions/pi-todo

Requirements

• macOS — uses Apple's Reminders app via a compiled Swift helper (EventKit)
• Swift — swiftc must be available (ships with Xcode or Xcode Command Line Tools)
• The Swift helper binary is auto-compiled on first run
• A "pi" list is auto-created in Apple Reminders if it doesn't exist

Usage

Ask the AI

Just talk to the AI about your tasks. It has a todo tool and knows when to use it.

> Add a todo to fix the login bug, high priority
> What's on my todo list?
> Mark the login bug as done
> Add a todo "Refactor auth module" with a description explaining we need to split the middleware

/todo command

Type /todo to open the interactive TUI:

──────────────────────────────────────────

  📋 Todos (1/3 done)

 ▸ ○ Fix login bug !!!
   ○ Refactor auth module …
   ✓ Set up CI pipeline

  ↑↓ navigate • x complete • Enter details • a add • d delete • r refresh • Esc close

──────────────────────────────────────────

List mode

| Key | Action | |-----|--------| | ↑ / k | Move up | | ↓ / j | Move down | | x / Space | Toggle done/undone | | Enter | Open detail view | | a | Add a new todo | | d / Delete | Delete todo | | r | Refresh from Apple Reminders | | Esc / q | Close |

Detail mode (press Enter on a todo)

| Key | Action | |-----|--------| | x / Space / Enter | Toggle done/undone | | e | Edit the description (opens multi-line editor) | | d / Delete | Delete todo | | Esc / q | Back to list |

Add mode (press a in list view)

1. Type a title, press Enter
2. Optionally type a longer description
3. Press Ctrl+S to save, or Esc to save without a description

Edit mode (press e in detail view)

| Key | Action | |-----|--------| | Esc / Ctrl+S | Save and go back |

LLM tool actions

The todo tool supports these actions:

| Action | Parameters | Description | |--------|-----------|-------------| | list | — | Show all todos | | add | title, body?, priority? | Create a new todo | | toggle | id | Toggle done/undone | | edit | id, title?, body?, priority? | Update a todo | | remove | id | Delete a todo | | clear | — | Delete all todos |

Priority levels: none (default), low (!), medium (!!), high (!!!)

Apple Reminders sync

• All todos live in the "pi" list in Apple Reminders
• Changes you make in pi show up immediately in Reminders (and on all your iCloud-synced devices)
• Changes you make in the Reminders app show up in pi when you press r in the TUI, or when the AI runs list
• Priority maps to Apple's system: high → !!!, medium → !!, low → !
• The description field maps to the Reminders "Notes" field

License

MIT