a pixel art crab that lives on your mac, watches your screen, and chats with you.
- pixel art crab walks along your dock icons
- tap to pet -- emotions escalate the more you tap (happy, love, surprised, scared, angry, dead)
- click to chat via Claude CLI
Cmd+Shift+Spaceto open chat from anywhere- proactive screen comments with emoji emotions (configurable interval)
- tamagotchi-style animations: bounce, shake, tremble, squash, pixel art effects
- works in fullscreen spaces
- auto-updates via Sparkle
- macOS 13+
- Claude CLI installed and authenticated
- Clawd defaults to Claude
sonnet; override withCLAWD_CLAUDE_MODEL=opusor another Claude model alias/name if needed
Download the DMG from releases, or build from source:
git clone https://github.com/advaitpaliwal/pet-clawd.git
cd pet-clawd
swift build
.build/debug/Clawd
To build a release .app and DMG:
./scripts/build-app.sh
The repository transfer changes source/download/feed locations, not the app's
bundle identity or update signing key. The current appcast.xml is an unsigned
XML feed with a signed archive enclosure; its archive signature and release
metadata are preserved. Do not edit a future signed XML feed without the normal
release signing process. Existing installed apps still contain their original
feed URL; these source changes do not publish a new app.
Run offline repository/feed consistency checks without building or signing:
python3 scripts/test-repository-links.py
- Accessibility -- required for the
Cmd+Shift+Spacehotkey - Screen Recording -- optional, enables proactive screen comments. granted on first launch or via menu bar toggle.
Everything runs locally. No data is collected or sent anywhere. Screen captures are compressed, sent to Claude CLI for context, and immediately deleted. The Claude CLI handles its own API communication.
MIT