A pixel pet that lives on your Mac screen, and answers what you copy.
Pick a cat or a dog. It walks, naps, chases a ball and wants pets.
Copy a question or take a screenshot, and it walks out holding the answer.
And a few quieter things:
- Private by default. The pet and its answer card stay out of screenshots, screen recordings and screen sharing, unless you tick Show in screenshots & recordings.
- Stays out of the way. It hides while a video player (VLC, IINA, QuickTime, TV, Netflix, Plex, Infuse) is in front.
- Idle takeover. Leave the Mac alone for half an hour and the pet grows and turns the screen into a glitch show. The first touch ends it and puts you back in your app.
- Stepped out. One click keeps your Mac awake and the screen on, like
caffeinate. - Click-through. The pet is drawn on a see-through layer. Your clicks always reach the app underneath.
- Download
ScreenCat-mac-<version>.zipfrom Releases and unzip it. - Drag ScreenCat into your Applications folder.
- Open it once. The app is not notarized by Apple yet, so macOS blocks the first launch: go to System Settings > Privacy & Security and click Open Anyway. On macOS 14 and earlier, right-click > Open, then Open, also works.
- Look at the top right of your menu bar for a little cat silhouette. Everything lives in that menu.
To start it every time you log in, tick Open at login in the menu.
Needs macOS 12 or later, Apple silicon or Intel.
Open the menu and go to LLM mode > Turn LLM mode on. From then on (until you choose Turn LLM mode off):
- Copy any text (a question, an equation, a claim, a word, an error message) and the pet walks on with a card: THINKING, then the answer.
- Take a screenshot (Cmd+Shift+4) and it answers what is in it. Add Control (Cmd+Ctrl+Shift+4) to copy the screenshot instead, which it picks up instantly.
- Ask about what I copied now asks once, with or without the mode on.
- Show answer box off: no pet, no card, the answer just lands on your clipboard. The menu bar icon shows 💭 while it thinks and ✅ when the answer is ready to paste.
Where answers come from. Either:
- Your own Anthropic API key. Choose LLM mode > Set API key… and paste a key from console.anthropic.com. It is kept in your Mac's keychain. You pay Anthropic per answer, usually a few cents at most.
- Claude Code. No key? If Claude Code is installed and logged in, Screen Cat uses it.
What is never sent: anything a password manager marks as private, files copied in Finder, whatever was already on the clipboard when you turned the mode on, the same text twice in a row, and text copied out of the pet's own card. Everything else you copy while LLM mode is on is sent to Anthropic to be answered.
| Item | What it does |
|---|---|
| Top line | What the pet is doing, or when it comes back. |
| Pause | Send the pet away until you resume. |
| Pet: Cat / Dog | Switch pets. |
| Mode: Normal / Crawler | Normal routines, or window-zapping hacker visits. |
| Play now | Walk, nap, ball, beg, ask to play, break some apps, crawl, Zero Day. |
| LLM mode | Turn answering on or off, show or hide the answer box, copy answers, set your API key. |
| Stepped out | Keep the Mac awake. A ☕ shows by the icon. |
| Show in screenshots & recordings | Let captures see the pet and its card. |
| Open at login | Start Screen Cat when you log in. |
| Open playground | A window with its own pet and pretend apps to play in. |
| Activity log / Settings | Open the local log, edit or reload settings. |
Everything is in ~/.screencat.json, created on first launch. Edit it with Settings > Edit settings file…, then Reload settings. A few you might want:
| Key | Default | Meaning |
|---|---|---|
pet |
cat |
cat or dog. |
sizeDivisor |
24 |
Bigger number, smaller pet. |
furColor |
#A87BE0 |
The cat's coat colour (the dog keeps its own). |
minGapSeconds / maxGapSeconds |
3 / 15 |
Quiet time between visits. |
blockedApps |
video players | Apps that make the pet hide while they are in front. |
idleCrawlSeconds |
1800 |
Idle time before the glitch takeover. |
llmModel / llmEffort |
claude-opus-5-5 / medium |
Which Claude model answers, and how hard it thinks. |
activityLog |
true |
Keep the local activity log. |
The full list, with every flag for testing, is in mac/README.md.
I opened it and nothing happened. It has no window and no Dock icon. Look for the cat silhouette at the top right of the menu bar. The pet itself comes out within about 20 seconds.
The pet disappeared. A video player is probably in front, or the menu says Paused. The top line of the menu always says why.
My Mac will not sleep. Stepped out is on (there is a ☕ next to the icon). Untick it, or quit Screen Cat.
LLM mode says it cannot find claude. Set an API key with LLM mode > Set API key…, or install Claude Code.
What is in the activity log? A plain-text diary in ~/Library/Logs/ScreenCat: which app was in front and for how long, sleep and wake, Bluetooth on or off, and what the pet did. It never leaves your Mac. Set activityLog to false to turn it off.
cd mac
./build.sh
open ScreenCat.app./release.sh builds and zips the app into mac/dist/ for a GitHub release and prints its SHA-256. The dog art is generated by swift mac/Tools/make_dog.swift, and --app-icon redraws the app icon.
| Platform | Folder | State |
|---|---|---|
| macOS | mac/ |
Working. Native Swift and AppKit, no dependencies. |
| Android | android/ |
Early port on the feat/android-port branch. |
| Windows | windows/ |
Early port on the feat/windows-port branch. |
- Cat art: "Cat Pack" by Glem / octopusINKUS, octopusinkus.itch.io/cat-pack, used with the artist's permission. If you want the cat art for something else, get it from the artist.
- Dog art: original, made for Screen Cat.
- Made by Oleanji.




