Clippy – Assistente Desktop macOS Nativo
companion-inc/clippy
Assistente desktop animado com IA local, voz e controle de máquina
Ver no GitHubAssistente visual macOS com animações clássicas, rodando localmente com suporte a ChatGPT/Claude, entrada por voz e ferramentas de automação de desktop. Oferece grounding visual, inteligência local-first e interface nostálgica similar ao Clippy original do Office.
Instalação
npx convez-ai companion-inc/clippy1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de tarefas repetitivas no desktop com suporte visual
- Interface conversacional sempre visível para consultas rápidas
- Integração com modelos Claude/ChatGPT mantendo dados localmente
- Assistência com entrada por voz (push-to-talk) em macOS
Veredito

Clippy é uma reimplementação criativa e funcional do assistente nostálgico, agora com IA moderna e capacidades de automação. Excelente para usuários macOS que querem IA acessível sem sair do desktop, mas requer setup de API keys locais e está limitado ao ecossistema Apple.
README
A tradução para o português deste README ainda está na fila.
Clippy
What Clippy Does
Clippy is a native Swift macOS app that keeps one animated Clippy character on
screen. Click it or use the command channel to chat, use the menu-bar eye or
right-click Clippy for the retro control menu, hold Control+Option to talk,
and let the assistant point at or operate the desktop through bundled local
tools.
The product path is local-first:
- The visible app, speech bubble, permissions UI, annotation overlay, character renderer, and app packaging live in this repository.
- The assistant brain runs through locally installed ChatGPT or Claude connectors. Existing local OpenAI/Anthropic API keys are offered in setup when account sign-in is not set up.
- First launch runs guided setup in Clippy's own speech bubble: choose ChatGPT or Claude, accept or replace discovered API keys, and grant Mac permissions.
- Voice input uses Deepgram when
DEEPGRAM_API_KEYis configured, with the Apple speech stack as the local fallback. Spoken replies use xAI TTS. - Computer-use calls run through the Clippy-bundled Cua helper in packaged builds.
Preview
| Idle | Attention | Gesture |
|---|---|---|
![]() | ![]() | ![]() |
Download
Download the current macOS build:
https://github.com/companion-inc/clippy/releases/latest/download/Clippy.dmg
Open the DMG, drag Clippy.app into Applications, and launch it. When macOS
blocks the first launch of a locally signed build, Control-click Clippy.app,
choose Open, and approve the prompt once.
Clippy checks for signed updates automatically in the background. You can also open the Clippy menu and choose Check for Updates....
Clippy asks for permissions only when the relevant feature needs them:
- Microphone for push-to-talk voice input.
- Screen Recording for screen grounding and pointing.
- Full Disk Access for local app databases.
- Accessibility for computer-use actions you approve.
Requirements
- macOS 13 or newer.
- One local account connector signed in, or installed with its matching local API key:
- Claude through
claude. - ChatGPT through
codex.
- Claude through
- Optional:
DEEPGRAM_API_KEYfor streaming speech-to-text. - Optional:
XAI_API_KEYfor spoken replies.
API keys can be supplied through the environment, Iris local settings, Clippy's
Configure API Key... screen for voice keys, or this local file:
~/Library/Application Support/Clippy/Secrets.json
{
"anthropicAPIKey": "...",
"openAIAPIKey": "...",
"sttAPIKey": "...",
"ttsAPIKey": "..."
}
Build From Source
swift test
swift build
To build the Launch Services app wrapper:
Scripts/package-clippy-app.sh release
open -n .build/release/Clippy.app
Scripts/package-clippy-app.sh requires a cua-driver binary so packaged
computer-use tools can run from inside Clippy.app. Set CLIPPY_CUA_DRIVER to
an existing binary, or install the Cua driver in one of the script's default
locations.
Developer Commands
The running app listens for optional debug commands through CLIPPY_CMD_FILE:
ask:<message>
open
hide
show
snapshot
move:<x>,<y>
park:lowerLeft|lowerRight|upperLeft|upperRight
state:idle|thinking|working|notification|attention|error|sweeping|carrying|juggling|sleeping
Repository Layout
Sources/Clippy- macOS application entry point.Sources/ClippyCore- character rendering, voice, local brain adapters, computer-use routing, permissions, windows, and runtime logic.Sources/ClippyMCP- helper MCP server for Clippy-owned annotations.Resources/Characters/Clippy- committed sprite pack and animation manifest.Resources/Clippy.icns- app icon.Scripts- packaging and asset export scripts.Docs- implementation status, architecture notes, verification matrix, and research handbook.
Release Process
Every push to main runs tests and packages the macOS app. Tagged pushes that
start with v publish GitHub Release assets:
Clippy.dmgClippy.dmg.sha256Clippy-macOS.zipClippy-macOS.zip.sha256SHA256SUMS.txtClippy-macOS.notarization.txtappcast.xmlfor Sparkle OTA updates
Contributing
Start with CONTRIBUTING.md. For architecture context, read Docs/STATUS.md and Docs/Handbook/README.md before changing runtime behavior.
License
Clippy is released under the MIT License.


