Repository navigation
Releases: aisocratic/clippy
Release list
Clippy v0.3.1
Signed and notarized macOS installer
This release replaces the prior ad-hoc-signed DMG with a Developer ID signed, Apple-notarized, and stapled installer. macOS should open it normally without a Gatekeeper bypass.
- Apple silicon (arm64)
- macOS 11 or newer
- SHA-256 checksum included
- Built from commit a75c906
Clippy 0.2.1 — the app finds its own updates
Cut from main at 4d59d26.
What's new since 0.2.0
- Release-aware update check — the packaged app's Updates panel (📎 → Settings → Updates) now compares its version against the newest GitHub release and links the fresh DMG directly. This is the first DMG that can tell you when the next one is out.
Everything from 0.2.0 — the light-card look, click-for-status summary, Codex + OpenClaw buddies, one-click hooks, organize-buddies, drag-direction facing — is included.
Install
Open the DMG, drag Clippy into Applications, and run it. arm64 (Apple silicon), macOS 11+. It is ad-hoc signed (not notarized), so right-click → Open the first time.
shasum -a 256 -c Clippy-for-Claude-Code.dmg.sha256 to verify the download.
Clippy 0.2.0 — light cards, a status summary, and three agents
The first release cut from merged main (commit 249635d).
What's new since 0.1.0
- Warm light-card look — every panel moves from the dark pixel textbox to the light card language of the site, with vector buddies and markdown-rendered cards.
- Click = status summary — clicking a buddy opens a compact card (state, what the agent is doing, model, context with 1M-aware limits); Expand grows it into the full usage panel.
- Three agents — Codex sessions get their own buddies, and OpenClaw gateway sessions join in watch mode.
- One-click hook install — a fresh install offers to write its hooks itself; the 📎 menu can re-install or update them any time.
- Organize buddies — line every free-floating buddy up along a screen edge from the tray menu; the edge sticks for new buddies.
- No more plan guessing — the Usage & limits settings section is gone; Clippy reads the real percentages Claude Code caches from
/usage. - Small touches — the menu-bar count now shows open buddies (tooltip says who's waiting), the hover name plate fits on one line, buddies face the way you drag them, and runtime polling got cheaper.
Install
Open the DMG, drag Clippy into Applications, and run it. arm64 (Apple silicon), macOS 11+. Intel users can build from source (npm run package).
Known limitations
- The DMG is ad-hoc signed, not notarized (no Developer ID on the build machine yet — see docs/RELEASING.md): right-click → Open on first launch.
- OpenClaw support is watch-mode only (no interactive cards yet).
shasum -a 256 -c Clippy-for-Claude-Code.dmg.sha256 to verify the download.
Clippy 0.1.0 — first packaged macOS app
First binary release of Clippy: a macOS menu-bar app that gives every Claude Code (and Codex) session a floating pixel buddy which surfaces permission requests, plans, questions, and end-of-turn reviews as clickable cards.
What's in this release
- Clippy-for-Claude-Code.dmg (~104 MB) — the packaged app, built with
npm run packagefrom branchtodo/one-click-hooks@ the PR #11 head (includes the Codex-support WIP #10, the 1M-context stats fix #7, and the one-click hook installer #11 — rebuild frommainonce those merge if you want an exact-main binary). Prebuilt Electron runtime with the app's source inContents/Resources/app/, buddy sprites pre-baked, ad-hoc signed (not notarized).
Install — no terminal needed
- Download the DMG, open it, drag Clippy for Claude Code into Applications.
- It is unsigned: right-click → Open the first time.
- Click Install hooks when the app offers — it writes only Clippy's own tagged entries to
~/.claude/settings.json(and Codex'shooks.json, if you use Codex). The menu-bar 📎 can re-install or update them any time.
Operational notes
- The app binds
127.0.0.1:43117only; nothing leaves the machine, and nothing is ever auto-approved. - With the app not running, the hooks no-op instantly (
--connect-timeout 1 … || true) — Claude Code behaves as if Clippy didn't exist. - Uninstall: the same tagged-entries-only removal via the app bundle's
clippy-hooks.js uninstall(ornpm run hooks:uninstallfrom source), then delete the app.
🤖 Generated with Claude Code