Claude Miss Minutes

An animated 1950s-cartoon clock who lives on your Mac desktop as a personal assistant, with Claude Code as her brain.

https://github.com/user-attachments/assets/f09c1bb5-2f68-4abd-9c0a-f0e1264d2623

An unofficial fan homage to a certain time-keeping hostess. The character is original vector art drawn in code; nothing here is affiliated with Marvel or Disney.

• Lives on your desktop: a click-through overlay on every Space. She sits on, climbs, hangs from and hops between your windows.
• Talks and listens: replies are spoken sentence by sentence with lip sync, in an open-source neural voice that runs on your Mac. Hold ⌃ to talk back.
• Thinks with Claude Code: one long-lived claude -p session, with tool permission prompts in her speech bubble that you can answer with a spoken yes or no.
• Has a body Claude can use: MCP tools to emote, walk to an app, look at your screen and set reminders.

**[Capabilities](docs/CAPABILITIES.md)**: everything she does, the controls, tool access, voice and permissions.

**[Architecture](docs/ARCHITECTURE.md)**: the modules, the frame loop, the screen map, a conversation end to end, and how to extend her.

Install

Requires macOS 14+ (Apple silicon or Intel) and [Claude Code](https://claude.com/claude-code), installed and signed in. Node.js is optional; without it she uses a macOS voice and Claude cannot move her.

**One line**: downloads the latest release, checks its checksum, installs it to Applications and opens her.

curl -fsSL https://raw.githubusercontent.com/imshaikot/claude-miss-minutes/main/Scripts/install.sh | bash

**Or the DMG**: download it from the [latest release](https://github.com/imshaikot/claude-miss-minutes/releases/latest), open it and drag Miss Minutes into Applications. The app is ad-hoc signed but not notarized, so macOS blocks t