A floating chat window that talks to a real LLM brain and drives your actual macOS desktop. Not a virtual sandbox, not a cloud VM. Open source, single 17 MB binary, zero subscriptions.
Go 1.22+ required. Grant Screen Recording + Accessibility on first launch.
Install
$ go install github.com/LocalKinAI/kinclaw/cmd/kinclaw@latestLaunch the floating chat UI
$ kinclaw serveOpens at http://127.0.0.1:8020/. For an app-like floating window: open -na "Google Chrome" --args --app="http://127.0.0.1:8020/?compact".
Cloud agents (Manus, Anthropic Computer Use, OpenAI Operator) run in their virtual machines. You can't see your Cursor, your Reminders, your private files. KinClaw runs on your Mac and operates the apps you already use.
kinclaw serve opens a single compact chat window in your browser. Operates your real macOS desktop alongside it — not a virtual sandbox, not a remote desktop. Markdown streams, soul switcher, session JSONL recording + replay.
🎙 push-to-talk via SenseVoice (CJK + English). 🔊 auto-spoken replies via Kokoro. Local audio service, no cloud roundtrip.
Hit a task with no skill? Pilot drafts SKILL.md, generates the script, registers it, retries the task. Circuit breaker prevents runaway loops.
spawn skill forks a specialist child (researcher / eye / critic / coder / curator) on a different brain. Hierarchical, kernel-capped at depth 1.
The kinclaw kernel is one Go binary. The KinClaw stack now adds a native macOS Spotlight shell and a sibling coding kernel. All three speak the same SSE event protocol + soul format — the shell drives both kernels with one client codebase.
Floating SwiftUI panel. ⌘⌥K from anywhere. Three modes in one window:
Auto-spawns kinclaw + kincode subprocesses with the right TCC identity (no "granted permissions but agent can't click Calculator" bugs). Brain dropdown reads your local Ollama install.
LocalKinAI/kinclaw-macRepo-aware coding agent. 10MB single binary. Pure stdlib. Same soul format as kinclaw — same .soul.md drives either kernel.
bash, file_*, glob, grep, web_*, memory, agent_spawn-serve mode: HTTP+SSE for desktop shellskimi-k2.6:cloud), Anthropic, OpenAI, MCPSame SSE event protocol on both kernels. Same soul-with-brain format. The Mac shell's KinClawAPIClient is a base-URL swap away from driving any future LocalKin kernel — future kinclaw-pal (Linux/Win Tauri shell) reuses the same client.
Each claw is independently usable. Four of them ship as pure-Go libraries you can pull into any project that needs to drive macOS at the framework level — no Xcode, no cgo, no Swift bridge.
Semantic UI control via macOS Accessibility tree (AX).
94% of macOS apps. ui find / read / click / tree / watch.
Real mouse + keyboard via CGEvent.
Smooth motion, target_pid background mode (no focus steal).
recordLocalKinAI/kinrec ↗Screen + audio capture, native MP4.
Non-blocking; tts narration captured in the same track.
web3-tier, cost-aware: URL-first (~50ms) → web (Playwright single-shot, ~3s) → browser_session (browser-use multi-step, persistent login).
T0 shell open + web_fetch + web_search + 14 URL templates baked into Pilot soul (Google Flights · Kayak · Booking · Airbnb · Zillow · Maps · GitHub · ArXiv · 12306 · …). T1 `web url=X click= type= js= screenshot=` — Playwright one-shot. T2 `browser_session task='登录 GitHub 找未读 PR'` wraps browser-use (91K★ OSS) for login + multi-page flows. Cross-platform — the only claw not bound to macOS, future Linux/Win port inherits all 3 tiers zero-rewrite.
See the Embedded Dylib paper for the distribution pattern these libraries share.
Other agent projects either run in the cloud (you can't see your real machine), or are bound to one app, or only operate browsers. KinClaw operates your whole macOS.
| Project | Where it runs | What it operates | Source |
|---|---|---|---|
| KinClaw | Your Mac | Your real macOS apps | MIT · open |
| Anthropic Computer Use | Cloud Linux VM | A virtual desktop | Closed · API |
| OpenAI Operator | Cloud browser | A browser only | Closed · beta |
| Manus | Cloud VM | Their virtual desktop | Closed · subscription |
| Open Interpreter | Local terminal | Shell only · no GUI | MIT · open |
| Cursor / Cline / Aider | Inside the IDE | Your code only | Mixed |
Part of the LocalKin family · macOS-only · native Swift shell kinclaw-mac shipped (v0.2.0)
Star on GitHub