farzaa /clicky

The open-source project HeyClicky grew out of. The official HeyClicky app, an AI buddy for Mac and Windows: heyclicky.com

★ 8,016⑂ 1,608👁 31⑃ 106● 47▤ 0
SwiftMITCreated 2026-04-07www.heyclicky.com
+3
日增长
8,016
stars
1,608
forks
31
watchers
106
prs
47
issues
0
releases

README

Get HeyClicky for Mac and Windows

The official app is HeyClicky, an AI buddy for Mac and Windows, made by me and the team.

- Mac: download HeyClicky for Mac (macOS 14.2 or later)
- Windows: download HeyClicky for Windows (Windows 10 and 11)

Those are the only official downloads. Other Windows apps built from this repo are community ports, not made by us.

---

Update: April 27, 2026.

Hi there! I'm Farza, the guy that made Clicky.

The existing codebase remains open source. Tinker with it, make it yours, start a company out of it, do whatever you want I don't mind. But, for all the new stuff I'm hacking on, gonna keep it private. To get the latest version, HeyClicky for Mac or Windows, go to heyclicky.com.

I also tweeted about this here.

Go crazy with this repo!! It's an MIT license.

 Hi, this is Clicky.
It's an AI teacher that lives as a buddy next to your cursor. It can see your screen, talk to you, and even point at stuff. Kinda like having a real teacher next to you.

Download HeyClicky for free for Mac or Windows.

Here's the original tweet that kinda blew up for a demo for more context.

!Clicky — an ai buddy that lives on your mac

This is the open-source version of Clicky for those that want to hack on it, build their own features, or just see how it works under the hood.

 Get started with Claude Code

The fastest way to get this running is with Claude Code.

Once you get Claude running, paste this:


Hi Claude.

Clone https://github.com/farzaa/clicky.git into my current directory.

Then read the CLAUDE.md. I want to get Clicky running locally on my Mac.

Help me set up everything — the Cloudflare Worker with my own API keys, the proxy URLs, and getting it building in Xcode. Walk me through it.


That's it. It'll clone the repo, read the docs, and walk you through the whole setup. Once you're running you can just keep talking to it — build features, fix bugs, whatever. Go crazy.

 Manual setup

If you want to do it yourself, here's the deal.

 Prerequisites

- macOS 14.2+ (for ScreenCaptureKit)
- Xcode 15+
- Node.js 18+ (for the Cloudflare Worker)
- A Cloudflare account (free tier works)
- API keys for: Anthropic, AssemblyAI, ElevenLabs

 1. Set up the Cloudflare Worker

The Worker is a tiny proxy that holds your API keys. The app talks to the Worker, the Worker talks to the APIs. This way your keys never ship in the app binary.

bash
cd worker
npm install


Now add your secrets. Wrangler will prompt you to paste each one:

bash
npx wrangler secret put ANTHROPIC_API_KEY
npx wrangler secret put ASSEMBLYAI_API_KEY
npx wrangler secret put ELEVENLABS_API_KEY


For the ElevenLabs voice ID, open wrangler.toml and set it there (it's not sensitive):

toml
[vars]
ELEVENLABS_VOICE_ID = "your-voice-id-here"


Deploy it:

bash
npx wrangler deploy


It'll give you a URL like https://your-worker-name.your-subdomain.workers.dev. Copy that.

 2. Run the Worker locally (for development)

If you want to test changes to the Worker without deploying:

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON