@beautifoo/pi-pomodoro
Pomodoro for Pi: a break when your 25 minutes are up, and a note that lets the agent sum up the session if that helps.
Package details
Install @beautifoo/pi-pomodoro from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@beautifoo/pi-pomodoro- Package
@beautifoo/pi-pomodoro- Version
0.3.0- Published
- Nov 10, 2026
- Downloads
- 821/mo · 821/wk
- Author
- lrnz09
- License
- MIT
- Types
- extension
- Size
- 68.9 KB
- Dependencies
- 0 dependencies · 1 peer
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
Pomodoro for Pi
After 25 minutes without a break, you get a reminder to take one, and your agent gets a note so it can sum up the session if that helps.
pi install npm:@beautifoo/pi-pomodoroIt runs in Pi's terminal UI only, not with -p, --mode json or RPC. The footer counts your pomodoros in sets of four, and your minutes. A break is 3 minutes with no keyboard or mouse input and no work from the agent (macOS idle time; elsewhere, no prompt, reply or tool call in any Pi session), and a long one, due after the fourth pomodoro, 15 minutes or more. /pomodoro today counts today's pomodoros and lists the check-ins in the repository you're in, and /pomodoro quiet holds the alerts during a meeting.
Settings go in ~/.pi/agent/pomodoro-settings.json, read when a session starts or on /reload, with these defaults:
{
"sound": true,
"emoji": true
}A key the file leaves out, or leaves empty, keeps its default. A value that isn't true or false, or a file that isn't valid JSON or can't be read, keeps the timer off, with an error that says why.
The repository has the details, and the same plugin for Claude Code. MIT licensed. Pomodoro Technique® is a registered trademark of Francesco Cirillo; this package isn't affiliated with it.