Marketplace
Petty plugins.
9 plugins ship bundled with Petty — you already have them. Below that sits the community seed pack: 8 optional plugins you can install, each a working example of the petty.* API.
Installing a plugin
Plugins are JavaScript that runs on your Mac. Depending on their declared permissions, they can read your clipboard, access your calendar, fetch from the internet, or shell out to allowlisted binaries. Only install from authors you trust, and read the manifest first — treat it like any other code you're about to run. To install, extract the zip into~/Library/Application Support/Petty/Plugins/ and restart Petty.Bundled with Petty
9 pluginsPomodoro Timer
v1.0.0builtin-pomodoro
Focus/break timer with pet reactions and menu controls. Petty sleeps through focus, wakes you when the break bell rings. Configurable durations.
Calendar
v1.0.0builtin-calendar
Meeting reminders at 15/5/0 minutes, a morning briefing, and calendar-aware quips. Reads macOS Calendar via EventKit.
Claude Code
v1.0.0builtin-claude-code
Reacts to Claude Code hook events via the petty:// URL scheme: task complete, needs attention, session start/end.
Git Status
v2.0.0builtin-git
Monitors git repositories for dirty files, unpushed commits, and merge conflicts. Shells out to the git binary every 60 seconds.
Weather
v1.0.0builtin-weather
Weather-aware quips based on temperature, conditions, and humidity. Fetches via wttr.in using CoreLocation.
Personality
v1.0.0builtin-personality
Core idle quips: time-of-day commentary, idle duration escalation, day-of-week moods, click reactions, and general flavor.
Clipboard Reactions
v1.0.0builtin-clipboard
Reacts to clipboard changes with context-aware quips for URLs, code snippets, and plain text.
App Awareness
v1.0.0builtin-app-awareness
Context-aware quips based on which app you're using and how long you've been in it. Gentle nags after 30+ minutes.
Idle Timer
v1.0.0builtin-idle-timer
The quip orchestrator. Collects quips from every other plugin, picks one by weight, and shows it on a configurable schedule.
Community seed pack
Optional plugins, install à la carte
Motivational Quotes
v1.1.0motivational-quotes
Feeds the idle quip pool with a rotating batch of quotes from ZenQuotes. Refreshes hourly; optional author attribution.
Dad Jokes
v1.1.0dad-jokes
Terrible jokes, fresh daily. Pulls ten at a time from official-joke-api and drops them into the quip pool.
Hacker News Headlines
v1.1.0hn-headlines
Polls the Hacker News front page and surfaces trending stories as quips. Menu item shows the current top story on demand.
ISS Tracker
v1.1.0iss-tracker
Occasionally mentions where the International Space Station is — and how far it is from you. Uses your location to compute distance.
Battery Watcher
v1.1.0battery-watcher
Polls pmset for battery state. Warns when the battery runs low, cheers when it's full, and shows the current percent in the menu.
Spotify Companion
v1.1.0spotify-companion
Shows the current Spotify track when it changes, and occasionally mentions what you're listening to. Only polls when Spotify is already running.
Standup Reminder
v1.1.0standup-reminder
Reminds you about your daily standup. Configurable time, weekdays-only, one notification per day. The simplest Petty plugin template.
Word Counter
v1.1.0word-counter
Drop a text, markdown, or source file on Petty to get line, word, and character counts. Batch mode totals across multiple files.
Want your plugin listed here?
A submission flow for third-party plugins is on the roadmap. For now, ship your plugin zip from your own repo and link to it — thepetty.* API is documented and stable.