v0.1.0-first-public-release

Hopet's first public release — a macOS desktop AI pet that mirrors the live state of your Claude Code and Codex CLI sessions.

Highlights

• Eight-state machine covering every meaningful agent transition: idle, responding, thinking, tool-use, permission-prompt, ask-user, completed, error-interrupted
• Multi-session aggregation — every active session feeds one pet, the highest-priority state wins, the driving session is visually highlighted
• One-click hook install / uninstall for Claude Code (~/.claude/settings.json) and Codex CLI (~/.codex/hooks.json) via non-destructive JSON merge
• Synchronous reply path for PermissionRequest and AskUserQuestion — Allow / Deny / structured answers travel back through the suspended hook socket, uniform across iTerm, Apple Terminal, VS Code, Cursor, Ghostty, and Warp embedded shells
• Built-in Hopi theme (8 hand-drawn pixel-seal animations) plus a custom theme importer — drop in 8 GIFs and you have your own pet

Install

1. Download Hopet-0.1.0.dmg below, open it, drag Hopet into Applications.
2. The build is ad-hoc signed (no Apple Developer ID), so macOS will block first launch. Bypass with either:
   • Right-click Hopet.app in Applications → Open → Open again in the confirmation dialog, or
   • xattr -dr com.apple.quarantine /Applications/Hopet.app
3. On first launch Hopet auto-installs hooks and copies hopet-emit to ~/.hopet/bin/. Existing hooks in your settings files are preserved.

Requirements

• macOS 14 (Sonoma) or later
• Apple Silicon only in this release. Intel Macs: build from source with scripts/build-release.sh 0.1.0 --universal (requires full Xcode).

See the README for the full feature list, architecture docs, and hook protocol.