@e9n/pi-calendar

Calendar tool, web dashboard, and reminders for pi

Package details

extension

Install @e9n/pi-calendar from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@e9n/pi-calendar

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ]
}

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

Calendar tool, web dashboard, and reminders for pi.

calendar tool — list, create, update, delete, today, upcoming (recurring events fully expanded)
Web UI — weekly calendar view at /calendar with drag-to-create, color-coded events, and recurrence support
REST API — JSON CRUD at /api/calendar
Reminders — checks for upcoming events every 60 s; sends notifications via pi-channels
Recurrence — daily, weekly, biweekly, monthly, yearly with custom intervals, day/position selection, end conditions, exclusions, and per-occurrence overrides

Add to ~/.pi/agent/settings.json or .pi/settings.json:

{
  "pi-calendar": {
    "dbPath": "db/calendar.db",
    "useKysely": false
  }
}

Key	Default	Description
`dbPath`	`db/calendar.db`	SQLite file path (relative to agent dir, or absolute)
`useKysely`	`false`	Use shared DB via pi-kysely instead of local SQLite

Action	Required params	Description
`list`	`range_start`, `range_end`	Events in a date range (recurring events expanded)
`today`	—	Today's events
`upcoming`	`days` (default: 7)	Events in the next N days
`create`	`title`, `start_time`, `end_time`	Create an event; optional: `recurrence`, `recurrence_rule`
`update`	`id` + fields to change	Update an existing event
`delete`	`id`	Delete an event

Served at /calendar (requires pi-webserver). REST API at /api/calendar.

pi install npm:@e9n/pi-calendar

MIT