Meowy for macOS

Website: https://meeowy.vercel.app

⚠️ First launch on macOS

Warning

macOS will warn before opening Meowy because it is ad-hoc signed, not notarized with a paid Apple Developer ID. Meowy is safe to use.

To open it the first time:

1. Go to System Settings → Privacy & Security
2. Scroll down to the Meowy security message
3. Click Open Anyway, then confirm

You only need to do this once; after that, Meowy opens normally.

Meowy is a small menu-bar app that puts a playful pixel-art cat on your Mac desktop.

Web page overview

A first look at the Meowy website.

Feature highlights

The key features and controls Meowy offers.

In action

Get to know about Meowy.

Requirements

• macOS 13 or later
• Swift and the macOS Command Line Tools

If Swift is not installed, run:

xcode-select --install

Build and run

Clone the repository, enter the project directory, and run:

./build.sh
open Meowy.app

The build script compiles the Swift sources, creates Meowy.app, bundles the cat sprites and app icon, and applies an ad-hoc local signature.

Use Meowy

Click the cat icon in the menu bar to choose:

• Start Meowy / Stop Meowy — one button toggles the cat on or off.
• Follow Cursor — follows the mouse around your desktop.
• Live on Dock — wanders along the Dock, pauses to scratch or relax, and takes occasional naps.
• Jokes — toggles the 5-minute joke bubble while docked.
• Joke Source — choose between Dark Jokes, Dad Jokes, Advice, and Quotes.
• Agents — submenu to enable/disable agent monitoring and choose which agents are monitored (Claude, Codex, Cursor, OpenCode).
• Music — submenu to enable/disable the now-playing bubble and choose Apple Music and/or Spotify as sources.
• Action Items — set reminders and pomodoro timers that appear in floating bubbles.
• Cat Name — rename the cat; hovering over the cat shows its name.
• Size — adjusts the cat from 50% to 300% (entered as a percentage).
• Speed — adjusts movement from 50% to 300% (entered as a percentage).
• Quit Meowy

Meowy remembers its position, size, speed, mode, joke/agent preferences, and selected cat name. Reduced Motion pauses the pet.

Agent status

When Agents is enabled, Meowy monitors Claude Code, Codex, Cursor, and OpenCode automatically:

• Shows “Thinking” while an agent is preparing a response.
• Shows the current tool activity, such as “Using Bash” or “Using Read”.
• Shows “work complete” with a notification sound, highlighted in green, then fades after about 7 seconds.

Cursor support covers the Cursor IDE agent (when its transcript is actively changing) and Cursor Agent CLI sessions.

OpenCode support reads OpenCode's local session database (~/.local/share/opencode/opencode.db), so it works with both the desktop app and the CLI. It shows reasoning, tool use (Bash, Read, Edit, Search, Web, Skill, and more), and streamed text live.

Reminders and pomodoro

• Reminder — schedule a reminder by minutes from now or by a specific time of day.
• Pomodoro — start a countdown timer with hours and minutes; the cat shows remaining time and plays a sound when it finishes.

All floating message bubbles (jokes, agent status, reminders, pomodoro) use consistent styling and remain visible without overlapping.

Development

Regenerate the app icon with:

swiftc -swift-version 5 -O -framework AppKit -framework CoreGraphics -framework ImageIO tools/MakeIcon.swift -o /tmp/MakeIcon
/tmp/MakeIcon /tmp/meowy.iconset
iconutil -c icns /tmp/meowy.iconset -o Resources/Meowy.icns
./build.sh