OpenClicky is a native macOS menu-bar AI companion, Clicky, offering push-to-talk voice help, screen-aware responses, and local agent capabilities. It prioritizes user privacy via local-only configuration, eliminating cloud-hosted accounts or key sync. This integration benefits users by providing AI assistance directly within their macOS workflow for tasks from simple queries to complex development.

How It Works

Clicky routes tasks via direct answers, web search, image galleries, or agent spawning, falling back to browser/UI automation. It supports local shell/file operations, frontend builds, and repo scaffolding. Key advantages include local-only configuration, no cloud sync, and an external control bridge for local apps to interact with its overlay, screenshots, and TTS.

Quick Start & Requirements

• Requirements: macOS 14.2+, Xcode with macOS SDK, configured Xcode signing team.
• Installation: Open cursor-buddy.xcodeproj in Xcode, select OpenClicky target, configure signing, run Cmd+R. Grant macOS permissions (Accessibility, Microphone, Screen Recording).
• Dependencies: Local API keys (Anthropic, ElevenLabs, OpenAI) via app settings or ~/.config/openclicky/secrets.env. Google Workspace integration requires gogcli (brew install gogcli) and local OAuth setup.

Highlighted Details

• External Control Bridge: Local HTTP server (http://127.0.0.1:32123) enables external apps to control cursor overlays, screenshots, captions, and TTS for agent integration.
• Bundled Agent Skills: Pre-built skills for Google Workspace via gogcli and native macOS screen control (pointing, captioning, visual tours).
• Swift SDK: OpenClickySDKSession allows embedding OpenClicky within other Swift applications.
• OTA Updates: Uses Sparkle for direct, signed Over-The-Air updates from GitHub Releases.

Maintenance & Community

Maintained by Jason Kneen. The README provides no details on community channels, sponsorships, or a public roadmap.

Licensing & Compatibility

Licensed under MIT. Compatible with commercial use and closed-source linking.

Limitations & Caveats

macOS-exclusive. Requires sensitive macOS permissions (Accessibility, Microphone, Screen Recording). Google Workspace integration needs separate gogcli setup and credentials.