Skip to content

About

A purple pixel cat that walks on your screen, with a crawler mode that fake-hacks your windows. Mac now, Android and Windows planned.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

21 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Screen Cat app icon: a purple pixel cat in sunglasses and a gold chain

Screen Cat

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.

macOS 12+ Swift, AppKit Version 1.1.0

Screen Cat demo: the cat walks in, naps, chases a ball, gets petted, answers a copied maths question, and the dog joins


What it does

The cat sits on the Dock while a pointer pets it and hearts float up The cat sits under an answer card that says x = 4 with the steps
A real little roommate. It walks along the bottom and the sides of your screen, naps with z's, chases its ball, begs for food, and asks you to play. Rest your pointer on it and it gets petted. It answers what you copy. Turn on LLM mode, copy a question or take a screenshot, and the pet walks out holding the answer: maths solved with the steps, facts checked, code explained, words defined. The answer is also put on your clipboard, ready to paste.
The purple cat and the tan pixel dog sit side by side, both in gold chains A fake Kernel Panic screen with HACKS YOUR SCREEN in glitchy letters
Cat or dog. Switch from the menu bar at any time, even mid-walk. Both wear a gold chain, and sometimes shades. It "hacks" your screen. Crawler mode zaps your windows with fake cracks and glitches. Zero Day is a three-minute fake hack of the whole screen, with sound. It is all paint: your apps are never touched.

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.

Install

  1. Download ScreenCat-mac-<version>.zip from Releases and unzip it.
  2. Drag ScreenCat into your Applications folder.
  3. 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.
  4. 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.

LLM mode

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.

The menu

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.

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.

FAQ

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.

Build from source

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.

Credits

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

About

A purple pixel cat that walks on your screen, with a crawler mode that fake-hacks your windows. Mac now, Android and Windows planned.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages