TopGit tracks farzaa/clicky on GitHub as part of the AI Tools family. The project has 7.4k stars.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
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 Clicky, you can go here.
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 it here for free.
Here's the original tweet that kinda blew up for a demo for more context.
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.
cd worker
npm install
Now add your secrets. Wrangler will prompt you to paste each one:
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):
[vars]
ELEVENLABS_VOICE_ID = "your-voice-id-here"
Deploy it:
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:
cd worker
npx wrangler dev
This starts a local server (usually http://localhost:8787) that behaves exactly like the deployed Worker. You'll need to create a .dev.vars file in the worker/ directory with your keys:
Then update the proxy URLs in the Swift code to point to http://localhost:8787 instead of the deployed Worker URL while developing. Grep for clicky-proxy to find them all.
3. Update the proxy URLs in the app
The app has the Worker URL hardcoded in a few places. Search for your-worker-name.your-subdomain.workers.dev and replace it with your Worker URL:
grep -r "clicky-proxy" leanring-buddy/
You'll find it in:
CompanionManager.swift — Claude chat + ElevenLabs TTS
Select the leanring-buddy scheme (yes, the typo is intentional, long story)
Set your signing team under Signing & Capabilities
Hit Cmd + R to build and run
The app will appear in your menu bar (not the dock). Click the icon to open the panel, grant the permissions it asks for, and you're good.
Permissions the app needs
Microphone — for push-to-talk voice capture
Accessibility — for the global keyboard shortcut (Control + Option)
Screen Recording — for taking screenshots when you use the hotkey
Screen Content — for ScreenCaptureKit access
Architecture
If you want the full technical breakdown, read CLAUDE.md. But here's the short version:
Menu bar app (no dock icon) with two NSPanel windows — one for the control panel dropdown, one for the full-screen transparent cursor overlay. Push-to-talk streams audio over a websocket to AssemblyAI, sends the transcript + screenshot to Claude via streaming SSE, and plays the response through ElevenLabs TTS. Claude can embed [POINT:x,y:label:screenN] tags in its responses to make the cursor fly to specific UI elements across multiple monitors. All three APIs are proxied through a Cloudflare Worker.
Project structure
leanring-buddy/ # Swift source (yes, the typo stays)
CompanionManager.swift # Central state machine
CompanionPanelView.swift # Menu bar panel UI
ClaudeAPI.swift # Claude streaming client
ElevenLabsTTSClient.swift # Text-to-speech playback
OverlayWindow.swift # Blue cursor overlay
AssemblyAI*.swift # Real-time transcription
BuddyDictation*.swift # Push-to-talk pipeline
worker/ # Cloudflare Worker proxy
src/index.ts # Three routes: /chat, /tts, /transcribe-token
CLAUDE.md # Full architecture doc (agents read this)
Contributing
PRs welcome. If you're using Claude Code, it already knows the codebase — just tell it what you want to build and point it at CLAUDE.md.
The most recent commit recorded on farzaa/clicky was 3 months ago, based on the GitHub push timestamp. The repository has 1.4k forks — one of the better signals of community interest.
How many stars does farzaa/clicky have?
farzaa/clicky has 7.4k GitHub stars — refresh the page for the live number, or check github.com/farzaa/clicky. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is farzaa/clicky open source?
Yes — farzaa/clicky ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/farzaa/clicky.
What else is in the AI Tools space?
farzaa/clicky is tracked by TopGit under the AI Tools category. Trending and Topics pages list peer repositories of comparable stars and language.
What is farzaa/clicky?
farzaa/clicky (farzaa/clicky) is a Swift project tracked by TopGit. The repository has 7.4k GitHub stars at the time of our last sync.
What language is farzaa/clicky written in?
farzaa/clicky is written primarily in Swift. GitHub's language field is based on the largest share of bytes in the default branch.
What license does farzaa/clicky use?
farzaa/clicky is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about farzaa/clicky?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/farzaa/clicky is the definitive source.
Read full README in the tab above.
Still deciding about clicky?
One click hands the question to an AI along with this page — see what it says about clicky.
/clicky