convez.ai
MCP ServerAutomaçãoIntermediário
companion-inc

Clippy – Assistente Desktop macOS Nativo

companion-inc/clippy

Assistente desktop animado com IA local, voz e controle de máquina

Ver no GitHub
BomPluginScore · de 0 a 100

Assistente 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/clippy

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
75%
Último commit
há 2 meses
Versão
v0.1.23
Issues abertas
0
Contribuidores
1

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_KEY is 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

IdleAttentionGesture
Clippy idleClippy attentionClippy 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.
  • Optional: DEEPGRAM_API_KEY for streaming speech-to-text.
  • Optional: XAI_API_KEY for 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.dmg
  • Clippy.dmg.sha256
  • Clippy-macOS.zip
  • Clippy-macOS.zip.sha256
  • SHA256SUMS.txt
  • Clippy-macOS.notarization.txt
  • appcast.xml for 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.

Ver o original no GitHub

Bom para

Relacionados