pi-reminders

Pi extension for Apple Reminders via rem CLI with dry-run confirmation.

Packages

Package details

extension

Install pi-reminders from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-reminders
Package
pi-reminders
Version
0.1.1
Published
Jun 10, 2026
Downloads
not available
Author
diwu507
License
MIT
Types
extension
Size
22.5 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-reminders

Pi extension for Apple Reminders on macOS, powered by the rem CLI.

This repository is extension-first:

  • Always-on /reminders smart slash command
  • Short aliases: /reminders_list, /reminders_add, /reminders_complete, /reminders_delete
  • reminders tool for explicit model-driven calls
  • Dry-run confirmations before every write
  • Double confirmation for delete
  • Default list: 近期待办

Features

  • list [query] or just /reminders
  • add <title> [absolute_due]
  • add <title> [absolute_due]; <title> [absolute_due] for quick batch creation
  • add --items '[{"title":"...","due":"YYYY-MM-DD"}]' for structured batch creation
  • complete <id_or_query>
  • delete <id_or_query>
  • Real RPC regression test for the full add → list → complete → delete flow

Quick start

  1. Install rem and grant macOS permissions:
    brew install BRO3886/tap/rem-cli
rem lists
  2. Add this repository path to ~/.pi/agent/settings.json under packages.
  3. Reload pi.
  4. Use:
    /reminders
/reminders_list
/reminders_add "Buy milk" 2026-06-17
/reminders_add "Call mom" 2026-06-17; "Pay rent" 2026-06-18
/reminders_add --items '[{"title":"Task A","due":"2026-06-17"},{"title":"Task B"}]'
/reminders_complete "Buy milk"
/reminders_delete "Buy milk"

Real runtime regression test

Run the extension through the actual pi --mode rpc --no-session protocol:

python3 scripts/test-extension-rpc.py
python3 scripts/test-extension-rpc.py --runs 2
python3 scripts/test-extension-rpc.py --batch-runs 2
python3 scripts/test-extension-rpc.py --triple-batch-runs 2
python3 scripts/test-extension-rpc.py --runs 1 --batch-runs 1 --triple-batch-runs 1

The test script automatically replies to extension UI prompts and verifies the result with rem.

Repository layout

pi-reminders/
├── README.md
├── package.json
├── index.ts
├── scripts/
│   ├── README.md
│   └── test-extension-rpc.py
└── doc/

Design notes

  • The extension talks to rem directly.
  • No MCP backend is used.
  • The public repo is extension-only.
  • The goal is a small, always-loaded reminder workflow that stays out of your way.

License

MIT