bleeeet/termipet

TermiPet is a macOS menu bar app that puts a small animated desktop pet at the edge of the screen for users who work in a terminal or with AI coding tools like Claude Code, Codex, and GitHub Copilot. The README frames it less as decoration and more as a workflow shortcut: the pet sits idle most of the time, and when the cursor moves near it, a floating toolbar with status cards, quick commands, a Pomodoro timer, and a chat window opens. The default pet is Terminal Cat, and other characters or custom pet resource packs can be loaded. Several integrations are documented. TermiPet detects active terminals across Terminal, iTerm2, Ghostty, Warp, WezTerm, Alacritty, and Kitty, and surfaces window titles and recent output in a preview card. A quick command panel ships with Claude Code commands like /compact, /clear, /review, /status, /diff, and /cost, and users can add their own. A folder picker types the matching cd command into the active terminal. A Claude Code Hook installs into ~/.claude/settings.json and ~/.claude/hooks/ and reports thinking, tool calls, permission prompts, context compaction, and completion back to the pet card. The pet chat window can talk to the user about the current state or hold a normal conversation. The model can be a local Ollama instance or an online API: OpenAI, Google Gemini, or any OpenAI-compatible custom endpoint. Privacy posture is spelled out clearly. TermiPet has no self-hosted relay server. Online model API keys live in the macOS Keychain, model base URLs and names live under Application Support, and Hook events go only to TermiPet's local 127.0.0.1 service. Installation has three routes: a packaged TermiPet.app from the GitHub releases page, a curl-piped install script, or a Homebrew tap with brew tap bleeeet/termipet plus brew install --cask termipet. Building from source uses Scripts/build-plugin.sh, which runs tests, builds the Swift Package, signs with a local self-signed certificate, and otherwise falls back to ad-hoc signing. Terminal preview and automatic typing require macOS Accessibility permission; without it the quick commands fall back to copying to the clipboard.