This is Roki. Named after the alien from Project Hail Mary because that little guy is the best companion ever written. Roki is an AI desktop companion that lives in your system tray, watches your screen, and helps you out when you need it.
Press a shortcut, grab a screenshot, send it to an AI, get an answer. Simple.
This project is a cross-platform port of Clicky by Farza. Clicky was the original macOS AI companion that inspired all of this. Roki rebuilds those same ideas for Windows.
Go check out Clicky at heyclicky.com. Farza's a genius, I'm just copyin' him.
Original Clicky is MIT-licensed at github.com/farzaa/clicky.
- Hit
Ctrl+Shift+Spaceor click the tray icon - Roki screenshots your monitors
- Sends them to an AI model with whatever you asked
- Streams the answer back in a little dark panel
That's it. You can swap between Claude, GPT-4o, Gemini, OpenRouter, or run Ollama locally if you're into that sort of thing.
The fastest way to get this running:
git clone https://github.com/your-org/roki.git
cd roki
bun install
cd apps/desktop
cargo tauri devIf you run into issues, Rust is probably crying about something. Make sure you've got the MSYS2 mingw64 toolchain on your PATH (C:\msys64\mingw64\bin). Windows things.
Throw 'em in the engine constructor:
const engine = new RokiEngine('anthropic', {
apiKey: 'sk-ant-...',
model: 'claude-sonnet-4-20250514',
})Supported providers:
- Anthropic (Claude) --
ANTHROPIC_API_KEY - OpenAI (GPT-4o) --
OPENAI_API_KEY - Google (Gemini 2.0 Flash) --
GEMINI_API_KEY - OpenRouter --
OPENROUTER_API_KEY - Ollama -- nothing needed, runs locally
bun run typecheck # checks all 10 packages
cd apps/desktop
cargo check # checks the Rust side| Part | Status |
|---|---|
| AI providers (5 of 'em) | Done |
| State machine (RokiEngine) | Done |
| Screen capture | Done |
| Tauri tray app + panel | Done |
| Voice pipeline | Workin' on it |
| TTS + element pointing | Soon |
| Settings + polish | Soon |
PRs welcome. The codebase is pretty straightforward:
apps/desktop/src-tauri/src/-- Rust backend (shortcuts, capture, overlay)apps/desktop/src/-- React frontend (panel, IPC bridge)packages/-- TypeScript packages (AI providers, engine, config, types)
Before you PR, run bun run typecheck and cargo check. Keep commits clean.
MIT. Originally by Farza, now yours too.
Go build something cool.