User guide

Get started with Wink

Everything you need, from download to your first task. Setup takes about 5 minutes: install Wink, paste your Claude API key, and start asking.

Requirements

MinimumRecommended
WindowsWindows 10, 64-bitWindows 11
GraphicsAny. Wink’s AI runs on Claude, so no special graphics card is needed.
Memory8 GB RAM16 GB RAM
StorageAbout 1 GB free2 GB free
Claude API keyYour own key from console.anthropic.com. You pay Anthropic for what you use.
MicrophoneOptional: you can type insteadAny headset or laptop mic
InternetNeeded while you use Wink, because it asks Claude about your screen.

1Get a Claude API key

Wink’s “brain” is Claude, made by Anthropic. Wink uses your own API key, so you only pay Anthropic for what you use.

  1. Go to console.anthropic.com and sign up or log in.
  2. Add a little credit under Billing. Wink uses Claude Haiku, Anthropic’s lowest-cost model.
  3. Open API keys, click Create key, and copy it. It starts with sk-ant-.

Keep the key to yourself. Wink saves it only on your PC.

2Install Wink

  1. Download the Wink installer (Winky-AI-Setup-x.y.z.exe).
  2. Open the file. Choose where to install it, or keep the default, and click Install.
  3. Leave Run Wink AI ticked and click Finish.

“Windows protected your PC”? Windows shows this for new apps it doesn’t know yet. Click More info, then Run anyway.

3First start: add your key

When Wink starts for the first time, it opens the Insights panel on the right of your screen:

  1. Paste your Claude API key into the box that asks for it and click Save.
  2. Wink checks the key. Once it works, the box goes away and Wink is ready.
  3. Hold Ctrl and ask something, or press Ctrl + Alt to type.

To change the key later, right-click the tray icon → Activity insights…. You can drag the panel’s edges to make it bigger, or use its maximize button to read reports full screen.

After that, Wink lives in the system tray: look for the blue pointer icon near the clock. If you don’t see it, click the ^ arrow to show hidden icons. Wink also downloads its voice models once (about 400 MB), so speech works on your PC.

Using Wink

Do thisWhat happens
Ctrl hold and speak, then let goYour words appear in a box at your cursor. Check or edit them, then press Enter or Send.
Ctrl + Alt press and let goA typing box opens at your cursor. Type your request and press Enter.
EscStops whatever Wink is doing, even in the middle of typing.
Move the mouse during a countdownTakes control back. Wink stops acting and just guides you.

Normal shortcuts like Ctrl + C never start voice. Voice only starts when you hold Ctrl on its own for a moment. A live waveform shows Wink can hear you.

Wink looks at the screen your mouse is on. On multiple monitors, move your mouse to the right screen before asking.

Guide me vs. do it for me

Questions (“how do I…?”) are guided:

  • A ring points at exactly what to click, with a checklist of every step.
  • Wink waits for your click, then points at the next thing.
  • Press ▶ Do it for me, or say “do it”, to let Wink finish the task itself.

Commands (“open Word and write…”) are done for you:

  • Wink shows its plan, then carries it out step by step.
  • Every action has a short countdown first, and Wink checks the screen after each step.
  • For writing, you’ll see “Writing… 120 words” while it works, then it types the text in.

To have Wink always do tasks itself, right-click the tray icon and choose Wink clicks for me.

Things to ask

How do I turn on dark mode? Change my desktop wallpaper Open Word and write a 200-word article about solar energy Open Notepad and type a shopping list Write an email asking my manager for Friday off How do I connect to Wi-Fi? What’s on my screen right now? Make this text bold

Short, clear requests work best. For long tasks, it helps to ask one part at a time.

The tray menu

Right-click the blue pointer icon near the clock:

ItemWhat it does
Send voice messages right awaySends what you said as soon as you let go of Ctrl, without the check-and-send box.
Wink clicks for meWink always does tasks itself.
I’ll click myself (guide only)Wink only points; you do the clicking.
Reset conversationWink forgets the conversation so far.
Open settings file / Reload settingsChange advanced settings (see below), then apply them.
Activity insights…Opens the Insights panel: your Claude API key, today’s work and reports.
Open data folderWhere Wink keeps its settings and voice models.
Open log fileWink’s log. Send this file along when you report a problem.
Check for updatesLooks for a newer Wink now, instead of waiting for the next automatic check.
QuitCloses Wink.

Updates

From version 0.3.0-beta.4, Wink updates itself:

  1. Wink checks for a newer version shortly after it starts, and every few hours after that.
  2. It downloads the update quietly in the background.
  3. A notification says “Wink is ready. Click to restart and update.” Click it, or choose Restart to update in the tray menu.

If you don’t click, the update installs the next time Wink closes. Your settings, key and voice models are kept.

On an older Wink? Versions before 0.3.0-beta.4 can’t update themselves. Download the installer once and run it over your current Wink. Nothing is lost, and every update after that is automatic.

Choosing a model

Wink uses Claude Haiku 5.5 by default: fast and low-cost. For harder tasks you can switch to Claude Sonnet 5.5, which costs more.

ModelSettingWhat to expect
Claude Haiku 5.5claude-haiku-5-5A few seconds per step. Good on common tasks. The default.
Claude Sonnet 5.5claude-sonnet-5-5Plans and clicks more carefully on long or unusual tasks.

To switch, set buddyModel in the settings file (see below), save, and choose Reload settings.

Settings

Right-click the tray icon → Open settings file, change what you need, save, then choose Reload settings.

{
  "taskMode": "guide",
  "voiceAutoSend": false,
  "buddyModel": "claude-haiku-5-5",
  "kokoroVoice": "af_heart",
  "speechSpeed": 1.05,
  "speak": true
}
SettingWhat it does
taskMode"guide": questions are guided until you approve. "auto": Wink always does tasks itself.
voiceAutoSendtrue sends voice messages straight away, without the check-and-send box.
buddyModelThe Claude model that answers. See Choosing a model.
kokoroVoiceWink’s voice. US: af_heart, af_bella, af_nicole, am_michael, am_fenrir. UK: bf_emma, bm_george.
speechSpeedHow fast Wink talks, from 0.5 to 2.
speakfalse keeps Wink silent; answers still show on screen.

Troubleshooting

“I need a Claude API key first”

Wink has no key yet. Right-click the tray icon → Activity insights…, paste your key and click Save. See Get a Claude API key.

“Your Claude API key didn’t work”

The key was mistyped, deleted, or cut short. Create a new one at console.anthropic.com and paste it in the Insights panel again.

“Your Claude account is out of credit”

Add credit under Billing at console.anthropic.com. Wink works again straight away.

“I can’t reach Claude”

Wink needs the internet to ask Claude. Check your connection and try again.

“I got confused there”

The model gave an answer Wink couldn’t read. Ask again, a little more simply. If it keeps happening, right-click the tray icon → Open log file and send the file to support.

“I didn’t catch that”

Wink didn’t hear any speech. Check that your microphone is on and selected in Windows (Settings → System → Sound → Input), then hold Ctrl while you speak. You can always type with Ctrl + Alt.

It’s slow

  • Each step takes a few seconds while Claude looks at your screen. A slow internet connection makes it longer.
  • Long writing tasks take longer, because Claude writes the whole text before Wink types it.

It clicked the wrong thing

Press Esc or move the mouse to take over. Asking again with a more specific request (“click the blue Save button at the top”) usually helps. Claude Sonnet is also more accurate; see Choosing a model.

It can’t control an app

Windows doesn’t allow normal apps to control windows that run as administrator. Wink can still guide you there; you just do the clicking.

I can’t find Wink

Look for the blue pointer near the clock, or click the ^ arrow to show hidden icons. If it isn’t there, start Wink AI from the Start menu.

Uninstall

  1. Open Settings → Apps → Installed apps, find Wink AI, and click Uninstall.
  2. Your settings and voice models are kept, in case you reinstall. To remove them too, first choose Open data folder from Wink’s tray menu and delete that folder.
  3. Your Claude API key stays in your Anthropic account. Delete it at console.anthropic.com if you no longer need it.

What Wink learns

Wink gets better at the things you do often:

  • From your tasks. When a task finishes, Wink remembers the steps that worked. Ask for something similar later, and Claude gets those steps as an example, so it plans faster and makes fewer wrong clicks.
  • From your reports. Each report also writes a short profile: your projects and where they live, the apps you use most, and how you like to work. Wink sends it with your questions, so “open my project” means the right thing.

You can see what Wink has learned in the Insights panel, under Learn from my tasks. Turn the switch off to stop it, or click Forget what Wink learned to delete it all. It’s kept only on your PC.

What it costs

Wink uses your own Claude API key, so Anthropic bills you for what Wink uses. The Claude usage card in the Insights panel shows today’s total and this month’s, split into answers, screen notes and reports.

  • Answers to your questions usually cost a fraction of a cent each on Claude Haiku.
  • Activity insights look at your screen every few seconds, so they add up over a working day. Turn them off in the panel if you don’t need them.
  • The figures are estimates from Anthropic’s prices. Your exact bill is at console.anthropic.com.

Privacy

  • When you ask Wink something, it sends a screenshot of your screen and your question to Claude, through your own API key.
  • With Activity insights turned on, Wink also sends a picture of the window in front every few seconds, so it can keep notes.
  • Speech recognition and Wink’s voice run on your PC. Your voice recording is never uploaded, only the text of your question.
  • Anthropic’s API doesn’t use your data to train its models. See Anthropic’s privacy policy for details.
  • What Wink learns stays on your PC. Only the parts that fit a question go to Claude along with it.
  • There’s no Wink account, no sign-in and no tracking in the app.

Still stuck? Check the FAQ, or reinstall Wink. Your settings and key are kept.