Documentation
Build for Petty.
Every built-in behavior — pomodoro, git, calendar, weather, Claude Code hooks — is a JavaScript plugin. The same API is yours. Pick a path.
Guide
Start here if you're new
Write your first plugin in a few minutes. Manifest format, the permission model, lifecycle, events, and shipping a zip.
API reference
Every petty.* namespace
Generated from the canonical petty.d.ts that ships with Petty — so it never drifts from the runtime.
Need TypeScript types?
Drop petty.d.ts next to your plugin'smain.js and add it to your jsconfig.json or tsconfig.json include.