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's main.js and add it to your jsconfig.json or tsconfig.json include.