claudeers.
// Automation & Workflows

poinky

Claude Code you talk to. Hold ⌃⌥ and it sees your Mac screen, answers out loud, sketches explanations, and runs Claude Code agents for you.

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up poinky (git-clone project) into my current project.
Found on https://claudeers.com/poinky
Repo: https://github.com/tomyud1/poinky
Homepage/docs: —
Detected install method: git-clone → git clone https://github.com/tomyud1/poinky
Category: automation. Platforms: cli, api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/tomyud1/poinky

// compatibility

Platformscli, api
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageSwift

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Poinky logo

Poinky

Ask about anything on your screen. It answers out loud and draws the explanation.

Demo: holding Control and Option, the user asks "How does it turn left?" about a drone article. Poinky answers out loud next to the cursor, boxes the matching table row, and a yellow pen sketches the drone on a paper beside it.

Poinky lives in your Mac's notch. Hold ⌃ Control ⌥ Option, ask out loud, let go. A little buddy at your cursor points at the answer while a yellow pen sketches it for you, like a friend explaining at your shoulder.

  • Explains by drawing. Step-by-step sketches in sync with its voice, or a 3D model you can spin.
  • Shows you the way. "How do I export this?" It circles each click and waits for you.
  • Does it for you. "Write an email to Sam" or "fill this in". It types, and asks before sending anything.

Install

One command. It checks your Mac, builds Poinky, installs the natural voice, and puts the app in Applications:

curl -fsSL https://raw.githubusercontent.com/tomyud1/poinky/main/install.sh | bash

Poinky is free and open source. It isn't notarized by Apple (that needs a paid developer account), so there's no download to double-click: the installer builds it on your Mac in a few minutes, which is also why macOS doesn't show a "downloaded from the internet" warning. The voice is a ~350 MB download. It asks before installing Claude Code. To skip the natural voice (Poinky then speaks with Apple's voice), end the command with bash -s -- --no-voice. Run the same command again to update.

What you need

RequirementDetails
A Mac with macOS 26 or laterBuilt and tested on Apple Silicon. Intel Macs on macOS 26 should work but are untested. A notch is optional (without one, Poinky lives in the menu bar).
Claude, one of:Claude Code, signed in, with a Claude Pro or Max plan (get it), or an Anthropic API key (pay per use; add it in Settings → Claude). Claude Code is needed for background agents ("go fix this in my project") and video explainers. Everything else works with just an API key.
InternetPoinky talks to Claude. Your voice is turned into text on your Mac.
Apple's Command Line ToolsFree, no Xcode needed. They bring Swift, git and python3, which build Poinky (and make video explainers: no Chrome or Node needed). The installer opens Apple's installer for you if they're missing (version 26 or newer).
macOS permissionsMicrophone and Speech Recognition (click Allow), Screen Recording (switch on by hand, see below), Accessibility (only if you ask Poinky to click or type for you).
About 0.6 GB of disk~0.16 GB for the natural voice, ~0.2 GB for the build, the rest for the source and the app. The Command Line Tools themselves are separate (~1 GB) if you don't have them.

The installer sets up everything else for you, in ~/Library/Application Support/Poinky: the natural voice (Phonon 31m by Gradium, runs on your Mac, English, Apache 2.0) with its own private Python (installed through uv), plus Poinky's settings and memory. Nothing is installed system-wide, and uninstalling removes it all. It also offers to install Claude Code if you don't have it.

First run

  1. Open Terminal, run claude once and sign in (skip if you use an API key).
  2. Hold ⌃ Control ⌥ Option, ask something, let go. macOS asks for Microphone and Speech Recognition: click Allow.
  3. Screen Recording has to be switched on by hand: System Settings → Privacy & Security → Screen & System Audio Recording → turn Poinky on, then reopen Poinky.

Troubleshooting

  • "Claude Code isn't installed" or a login error: run claude in Terminal and sign in, or use an API key (✨ menu → Settings → Claude).
  • It doesn't see my screen: Screen Recording is off. Turn it on, then quit and reopen Poinky.
  • macOS asks for permissions again after an update: the installer makes a local signing certificate ("Poinky Local Signing") so it shouldn't. If you clicked "Don't allow" when macOS asked to let codesign use it, run the installer again and choose Always Allow.
  • No natural voice: run the install command again (it only adds what's missing), or pick Apple voices in Settings → Voice.
  • The build failed: the installer prints the end of its log. The whole log is in ~/Library/Application Support/Poinky/install.log; please attach it to an issue.

Uninstall

curl -fsSL https://raw.githubusercontent.com/tomyud1/poinky/main/install.sh | bash -s -- --uninstall

It removes the app and the source, and asks before deleting your settings, memory and the voice (add --purge to skip the question). macOS keeps the permissions list itself: remove Poinky there if you want it gone from System Settings.

Use it

Do thisTo
Hold ⌃⌥ and talkAsk about your screen
Hold ⌃⌥ and drag with the mouseCircle what you mean
Tap ⌃⌥Stop it
⌃⌥SpaceHands-free conversation
Ask "make me a video about…"A narrated animated explainer, drawn by code. It takes a few minutes (a helper makes it while you work) and opens full screen when it's ready: Space pause, ← → sentence, Esc close, hold ⌃⌥ to ask about it. Needs Claude Code and the natural voice.

Private by design: your voice is turned into text on your Mac, and screenshots go only to Claude, only when you ask. No accounts, no tracking. More on privacy and safety →

Where it's going

Claude Code agents that live on your screen instead of in a window. Ask Poinky for something big and a small colored helper buds off your cursor, flies to the side of the screen, and works there with live progress notes. When it's done, it flies back and Poinky tells you what it did. Read the vision and plan →

Learn more

User guide · Vision · How it works · Changelog · Contributing · Security · Third-party notices

Inspired by Clicky. MIT © 2026 Tomer Yudovic.

// faq

What is poinky?

Claude Code you talk to. Hold ⌃⌥ and it sees your Mac screen, answers out loud, sketches explanations, and runs Claude Code agents for you.. It is open-source on GitHub.

Is poinky free to use?

poinky is open-source under the MIT license, so it is free to use.

What category does poinky belong to?

poinky is listed under automation in the Claudeers registry of Claude-compatible tools.

0 views
★ 10 stars
unclaimed
updated about 1 hour ago

// embed badge

poinky on Claudeers
[![Claudeers](https://claudeers.com/api/badge/poinky.svg)](https://claudeers.com/poinky)

// retro hit counter

poinky hit counter
[![Hits](https://claudeers.com/api/counter/poinky.svg)](https://claudeers.com/poinky)

// reviews

// guestbook

0/500

// related in Automation & Workflows

🔓

The agent that grows with you

// automationNousResearch/⟨Python⟩★ 264,763◷ MIT[ claude ]
🔓

The API to search, scrape, and interact with the web at scale. 🔥

// automationfirecrawl/⟨TypeScript⟩★ 199,533◷ AGPL-3.0[ claude ]
🔓

🌐 Make websites accessible for AI agents. Automate tasks online with ease.

// automationbrowser-use/⟨Python⟩★ 121,235◷ MIT[ claude ]
🔓

Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop

// automationLeonxlnx/⟨JavaScript⟩★ 119,754◷ MIT[ claude ]
→ see how poinky connects across the ecosystem