@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.

Packages

Package details

extension

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

npm repo home report

$ pi install npm:@beautifoo/pi-pomodoro

Package: @beautifoo/pi-pomodoro
Version: 0.2.2
Published: Nov 6, 2026
Downloads: 569/mo · 569/wk
Author: lrnz09
License: MIT
Types: extension
Size: 29 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-pomodoro

It runs in Pi's terminal UI only, not with -p, --mode json or RPC. The footer counts your minutes, and a break is 5 minutes with no keyboard or mouse input (macOS idle time; elsewhere, no prompt or tool call in any Pi session). /pomodoro today lists today's check-ins by repository.

Settings go in ~/.pi/agent/pomodoro-settings.json, read when a session starts or on /reload, with these defaults:

{
	"workMinutes": 25,
	"breakMinutes": 5,
	"moveSeconds": 1,
	"sound": true,
	"checkIn": true,
	"emoji": true
}

A key the file leaves out, or leaves empty, keeps its default. workMinutes and breakMinutes take 1 or more, moveSeconds 0 or more: a value of the wrong kind or below that, 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.