Marketplace

Petty plugins.

Start with a curated collection and install several plugins in one click, or browse à la carte. 8 plugins ship bundled with Petty (you already have those) and 8 more live in the community seed pack — 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.

Install in Petty downloads the zip, shows you the declared permissions in a confirmation dialog, and drops it into your plugins directory — no restart needed. Prefer to inspect first? Grab the .zip and extract it manually into ~/Library/Application Support/Petty/Plugins/.

Collections

Curated setups, one click each

A collection bundles several plugins into a shareable pack. Click Install Pack and Petty fetches each one, shows you the combined permissions in a single dialog, and installs them together — all-or-nothing. Packs are just JSON; anyone can host their own.

3 packs

Focus Mode

3 plugins

focus-mode

Tight productivity loop. Pomodoro sleeps the pet through focus and wakes you when the break bell rings; the git watcher keeps an eye on dirty files; Claude Code hooks let your editor poke the pet.

  • Pomodoro Timerbuiltin-pomodoro
  • Git Statusbuiltin-git
  • Claude Codebuiltin-claude-code
execstoragesystem
Install Pack.json

Daily Joy

3 plugins

daily-joy

Ambient amusement. Motivational quotes, dad jokes, and Hacker News headlines feed Petty's quip pool throughout the day so the pet always has something to say.

  • Motivational Quotesmotivational-quotes
  • Dad Jokesdad-jokes
  • Hacker News Headlineshn-headlines
networkstorage
Install Pack.json

Mac Companion

4 plugins

mac-companion

Live system awareness. Battery alerts, Spotify track changes, weather quips, and calendar reminders turn Petty into a status-aware sidekick that knows what's happening on your Mac.

  • Battery Watcherbattery-watcher
  • Spotify Companionspotify-companion
  • Weatherbuiltin-weather
  • Calendarbuiltin-calendar
calendarexecnetworkstoragesystemweather
Install Pack.json

Roll your own pack

Host a JSON manifest anywhere with HTTPS (a gist works) and link users to petty://install-pack?url=<your-json>. The format is documented in the distribution guide.

Bundled with Petty

8 plugins

Pomodoro Timer

v1.0.0

builtin-pomodoro

Focus/break timer with pet reactions and menu controls. Petty sleeps through focus, wakes you when the break bell rings. Configurable durations.

systemstoragebundled
Download source

Calendar

v1.0.0

builtin-calendar

Meeting reminders at 15/5/0 minutes, a morning briefing, and calendar-aware quips. Reads macOS Calendar via EventKit.

calendarsystemstoragebundled
Download source

Claude Code

v1.0.0

builtin-claude-code

Reacts to Claude Code hook events via the petty:// URL scheme: task complete, needs attention, session start/end.

systembundled
Download source

Git Status

v2.0.0

builtin-git

Monitors git repositories for dirty files, unpushed commits, and merge conflicts. Shells out to the git binary every 60 seconds.

execsystembundled
Download source

Weather

v1.0.0

builtin-weather

Weather-aware quips based on temperature, conditions, and humidity. Fetches via wttr.in using CoreLocation.

weathernetworksystemstoragebundled
Download source

Personality

v1.0.0

builtin-personality

Core idle quips: time-of-day commentary, idle duration escalation, day-of-week moods, click reactions, and general flavor.

systembundled
Download source

Clipboard Reactions

v2.0.0

builtin-clipboard

Reacts to clipboard changes with context-aware quips for URLs, code snippets, and plain text.

clipboardstoragebundled
Download source

App Awareness

v2.0.0

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

active-appstoragebundled
Download source

Community seed pack

Optional plugins, install à la carte

8 plugins

Motivational Quotes

v1.1.0

motivational-quotes

Feeds the idle quip pool with a rotating batch of quotes from ZenQuotes. Refreshes hourly; optional author attribution.

networkstoragecommunity
Install in Petty.zip

Dad Jokes

v1.1.0

dad-jokes

Terrible jokes, fresh daily. Pulls ten at a time from official-joke-api and drops them into the quip pool.

networkstoragecommunity
Install in Petty.zip

Hacker News Headlines

v1.1.0

hn-headlines

Polls the Hacker News front page and surfaces trending stories as quips. Menu item shows the current top story on demand.

networkstoragecommunity
Install in Petty.zip

ISS Tracker

v1.1.0

iss-tracker

Occasionally mentions where the International Space Station is — and how far it is from you. Uses your location to compute distance.

networksystemstoragecommunity
Install in Petty.zip

Battery Watcher

v1.1.0

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

execstoragecommunity
Install in Petty.zip

Spotify Companion

v1.1.0

spotify-companion

Shows the current Spotify track when it changes, and occasionally mentions what you're listening to. Only polls when Spotify is already running.

execstoragecommunity
Install in Petty.zip

Standup Reminder

v1.1.0

standup-reminder

Reminds you about your daily standup. Configurable time, weekdays-only, one notification per day. The simplest Petty plugin template.

systemstoragecommunity
Install in Petty.zip

Word Counter

v1.1.0

word-counter

Drop a text, markdown, or source file on Petty to get line, word, and character counts. Batch mode totals across multiple files.

execcommunity
Install in Petty.zip

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 — the petty.* API is documented and stable.