Getting started with Wisp

Install Wisp

Download Wisp from the Wisp website. It's free to start, and you can upgrade any time.

On a Mac

1. Go to the Wisp website and click Download for Mac.
2. Open the downloaded Wisp-Mac disk image (.dmg).
3. Drag the Wisp icon into your Applications folder.
4. Open Applications and double-click Wisp.
5. If your Mac asks “Are you sure you want to open it?”, click Open.

On a Windows PC

1. Go to the Wisp website and click Download for Windows.
2. Open the downloaded installer (Wisp-Setup.exe).
3. If Windows shows “Windows protected your PC”, click More info, then Run anyway.
4. Wisp installs in a few seconds and starts on her own. After that you'll find her in the Start menu.

First launch

The first time Wisp opens, you'll sign in, then she'll introduce herself and take you on a short getting-started tour. Want to see it again later? Open the bag over Wisp and choose Getting-started tour, or just say “Show me around again.” You can skip or end the tour at any time, and it remembers where you stopped.

Updates

When a new version is out, Wisp lets you know and adds a Download Wisp (new version) item to her menu. Nothing installs without you.

Give Wisp the permissions she needs

Wisp needs your permission to hear you and to work your apps for you. She only uses these to do what you ask.

On a Mac

When Wisp asks for a permission, click Open System Settings, then:

1. Go to System Settings > Privacy & Security.
2. Click Accessibility and turn on the switch next to Wisp.
3. Click Screen Recording (called Screen & System Audio Recording on newer macOS) and turn on Wisp.
4. Click Microphone and turn on Wisp.
5. If macOS asks you to quit and reopen Wisp, click Quit & Reopen.

You may also see Wisp's helpers, such as Wisp Voice, Wisp Hands and Wisp Calendar, in these lists. Turn those on too; they're part of Wisp.

On Windows

Windows usually only asks about the microphone. If Wisp can't hear you:

1. Open Settings > Privacy & security > Microphone.
2. Turn on Microphone access and Let apps access your microphone.
3. Make sure Wisp is turned on in the list.

Talk to Wisp

Push-to-talk

Push-to-talk is how you start a request by default, so Wisp isn't listening unless you want her to.

1. Double-tap Left Command on a Mac or Left Alt on Windows. A small recording pill appears under Wisp.
2. Say what you need.
3. Double-tap again, or click the ✓ on the pill, to send it. Click ✕ or press Esc to cancel.

Hands-free: “Hey Wisp”

Want her listening all the time? Open Wisp's menu, choose Listening, and pick Always listening (“Hey Wisp”). Then just say “Hey Wisp” and she floats onto your screen, ready to listen: “Hey Wisp, find me a good video on sourdough.” Say “Dismiss” when you're done and she'll drift off your screen.

Type instead

In a meeting or a quiet library? Double-tap Right Command on a Mac or Right Alt on Windows to open a small text bar, type your request, and press Return. Esc closes it.

All keyboard shortcuts

Interrupt or stop her

Wisp doesn't listen while she's talking, so she won't mishear herself. To cut in:

• Click the Stop button under her. It shows whenever she's speaking or working, and it silences her and drops the task.
• With Always listening on, say “Hey Wisp” or “Stop.”

She keeps working on anything you've asked for in the background, even when she's off your screen.

Around Wisp

Hover over Wisp and three little bubbles appear:

• “…” above her opens the Conversation, everything you've said to each other since she started. Copy it or clear it any time.
• The gear opens Settings, grouped into Account, Listening & voice, Appearance, Permissions, Routines, Building, Open, Play, Power and More.
• The bag opens her Inventory: your notes, projects, to-do lists, calendar, documents, skills, news, morning brief, connected apps, team and games, all in one place.

While she's thinking, her thoughts show in a thought bubble. Tap it to open the Thinking log and see every step she takes: what she thought, what she searched for (with sources) and which tools she used.

Right-click Wisp, or click her icon in the menu bar (Mac) or system tray (Windows), for her full menu. Her spoken words also float over her head as captions. If they're hard to read, turn on Caption background (easier to read); it's on by default.

You can also change her Size, Wisp color, Follow my mouse, and Come back to your spot from the menu. Wisp stays out of your screen recordings and screen shares unless you turn on Show Wisp in screen recordings.

Plans and pricing

Wisp comes in three plans: Free, Plus, and Pro.

• Free gives you everyday Wisp and 10 minutes of her premium voice every month, plus 15 smart tasks to try building, designing and research, on us. Free smart tasks are one-time; everything else starts again on the 1st. To go past that, add your own keys and keep going for free: an Anthropic API key (from console.anthropic.com) for thinking and building, and optionally an ElevenLabs API key for the premium voice. You pay those companies directly, only for what you use. Without an ElevenLabs key, Wisp talks in her natural voice, which is always free.
• Plus and Pro run on Wisp's own keys, so there's nothing to set up. Each includes a set number of smart tasks and premium-voice minutes every month. If you use them all, you can top up or upgrade.

Smart tasks count by how much work they take. They're for Wisp's three biggest jobs, which run on her most capable model: building software, making designs, and researched documents. A design usually uses one; an app, a game or a big researched report uses a few, depending on its size. Everything else Wisp does doesn't use any: chat, web lookups, using your computer, quick sketches, and light documents like invoices, letters and short briefs written from what you tell her. Each plan includes a generous number of web searches a month (fair use); past that, Wisp keeps helping and answers from what she knows until the next month. You can add your own keys on any plan, and anything that runs on them never counts against your plan.

Open Wisp's menu and choose Plan to see what's left, upgrade, switch to yearly billing (2 months free), top up, see billing and invoices, or cancel. Add keys under Plan > Your own AI keys. You can also just ask: “Hey Wisp, how many tasks do I have left?” Or manage everything on your account page. See Pricing for current prices and limits.

What Wisp can do

Your day

Wisp's calendar

Wisp has a calendar of her own that works like any calendar app, and it can show your Google and Apple calendars right alongside it. Open it from the bag (Calendar), or ask: “What's on my calendar this week?”

• Switch between Day, Week and Month (or press D, W, M). T jumps to today.
• In Day or Week view, drag across empty time to add an event, drag an event to move it, and drag its bottom edge to make it longer or shorter. In Month view, double-click a day to add an all-day event. Or click + Event (N).
• Events can have a place, notes, an alert, a video call link, and a repeat: every day, every weekday, every week, every 2 weeks, every month or every year, with an optional last day.
• To connect your other calendars, click Connect Google Calendar or Connect Apple Calendar (Mac only) in the sidebar. Changes go both ways. Tick calendars on or off, and star the one new events should go into.
• Or just say it: “Book lunch with Sam Thursday at noon,” “When am I free tomorrow afternoon?” or “Move my dentist to Friday.” On Google calendars she can invite people and add a Meet link too.

Wisp's own calendars sync to every computer you sign in on. For events on Wisp's calendar, she'll pop up a reminder and say it out loud.

Morning brief

Say “Brief me” or “Good morning, what's my day look like?” and Wisp pulls together today's calendar, the email that matters, Slack messages to you, the weather, top news and your open to-dos. She reads it out and shows it in a panel; click anything to ask her about it.

To get it automatically, open her menu and choose Morning brief > Every morning (or Weekdays only) and pick a time. She'll brief you the first time you're at your computer after that time. For local weather, tell her where you are: “I'm in Providence.”

Email

Wisp can read, sort, reply to and write your email. Set it up once under Connected apps > Email > Set up, and pick one of three ways:

• Apple Mail (Mac): uses the accounts already in your Mac's Mail app. Nothing to sign in to.
• App password (Mac and Windows): enter your email address and an app password. Click How do I make one? for Gmail, iCloud, Yahoo, Fastmail or Zoho. You can add several addresses.
• Claude: uses the Gmail connector in your own Claude. You'll need Claude Code installed and Gmail turned on in Claude. It's a bit slower, and one-click archive and star aren't available.

Emails open in a mail panel beside Wisp, with Reply, Reply all, Star, Archive and Move to Trash. When Wisp writes a reply for you, she puts it in the panel so you can check it and press Send yourself. Try “Anything important in my inbox?” or “Reply to Dana and say Tuesday works.”

News

Ask “What's in the news?” for a short spoken briefing, or open News from the bag to browse stories from Google News, BBC and NPR. Follow topics (“Follow climate news”), mute ones you're tired of (“Less politics”), or add your own RSS feeds. Each story has Read and Ask Wisp.

Social feeds

Wisp can skim X, Facebook, Instagram and LinkedIn and tell you what's going on. It's off until you turn on Social feeds > Let Wisp read my feeds in her menu, then sign in to each site yourself in Wisp's own window. Ask “Catch me up on socials,” or turn on Check twice a day. She keeps each look short and never saves the posts she reads.

Notes and lists

Notebook

Say “Take a note that the gate code is 4471” and it goes in Wisp's notebook, her own notes window. Search, copy, export a note as a text file, or write in it yourself. Notes sync across your computers. (Want Apple Notes instead? Just say so.)

To-do lists

Ask “Make me a to-do list for moving day” and you get a real list you can check off, edit and rename. Add to it any time: “Add bubble wrap to my moving list.”

Teams and shared lists

Share to-do lists with family or coworkers who use Wisp. Open Team from the menu or bag, click Make a team, and invite people by email. They'll see the invite next time they sign in to Wisp with that address. Changes show up for everyone within about a second. Try “Make a shared list for the team.”

Connected apps

Connect the apps you already use, then just ask. Open Connected apps from Wisp's menu or bag, or say “Show my connected apps.” Click Connect, then Allow on the app's own sign-in page in your browser.

Most connections are saved to your Wisp account, so sign in to Wisp first and they'll follow you to every computer. Email, Apple Calendar, Granola and Wispr Flow are set up on each computer.

Claude

Wisp works with Claude in three ways.

Hand off whole jobs to Claude

For big jobs, Wisp can hand the work to Claude Code on your computer and see it through to the end, so you get a finished result, not a list of steps to run yourself. Try “Have Claude make me a website for my bakery and send me the link.”

• You'll need Claude Code installed (free, from claude.com/claude-code) and signed in. If you aren't signed in, Claude's sign-in page opens and the task starts on its own afterward.
• Tasks run in the background, in Documents/Wisp/Claude tasks or in a project folder you name.
• If Claude wants to do something risky, Wisp asks you out loud with a card: Yes, Yes to all or No. No answer in 3 minutes counts as no.
• When it's done, Wisp tells you and offers to open it. Tasks survive restarts, and you can ask her to carry on with one later.

Start a Claude chat

Ask Wisp to start a chat in Claude and she opens claude.ai with her prompt already typed in. You just press send.

Use Wisp inside the Claude app

Click Connect on the Claude row in Connected apps. You'll need the Claude desktop app installed and opened once. Quit and reopen Claude, and it can use your Wisp to-do lists, notebook and memory. Wisp can't read your Claude chats.

Documents

Wisp can research across your apps, your files and the web, and write a real document with its sources cited. Ask for a report, project overview, status update, brief, proposal, meeting prep, memo, summary or analysis:

• “Go through my Slack, email and docs about the launch and write a project overview.”
• “Put together meeting prep for my call with Acme.”

Watch progress in the Documents window. Each one is saved as a web page and a PDF in Documents/Wisp/Reports, and you can save it to Google Drive or ask for changes later (the old version is kept). While researching, Wisp only reads; she never sends or edits anything.

Wisp sizes each job to what it needs. Light documents, like an invoice, a letter or a short brief written from what you tell her, are quick and don't use smart tasks. Anything that reads across your apps or the web, and real reports and analyses, gets her most capable model and uses a few smart tasks, depending on size.

• “Write an invoice to Acme for 20 hours of design at $150 an hour, due in 30 days.” (light)
• “Go through everything with Acme this quarter and write a status report.” (researched)

Want it to look designed rather than read like a report? Ask for a design instead (see Designs).

Designs

Wisp has a designer. Ask for something polished, and her most capable model makes it for you.

• Single pieces: logos, icons, posters, flyers, social posts, banners, business cards and mockups of app screens or web pages. “Design a logo for my bakery, Bloom, warm and simple.” It draws itself in on her sketchpad while you watch, and is saved to Pictures/Wisp Drawings. Say “Save it as a PDF” to get a PDF too.
• Documents and decks: one-pagers, brand guidelines, brochures, menus, media kits and pitch decks, laid out as real pages (Letter, A4 or 16:9 slides). “Design a 10-slide pitch deck for Bloom.” These take a few minutes in the background; the PDF opens when it's ready, saved in Documents/Wisp/Designs.

Ask for changes any time (“Make the logo green”, “Add a pricing slide”); the previous version of a document is kept. A design usually uses one smart task, and a long document or deck a few. Quick sketches and diagrams (“Draw me how our team works”) stay free.

Skills

When you correct how Wisp handles something, she remembers and does it your way every time after that. These are her skills.

• Tell her outright: “From now on, put invoices in my Finance folder.”
• Or just correct her (“No, put it in the shared drive instead”) and she'll learn from it.

Wisp tells you whenever she saves a skill. Open Skills from the menu or bag to see them all, edit them, turn them off or on, go back to a previous version, delete them, or Write a new skill yourself.

Files and windows

• Organize folders. “Organize my Downloads.” Wisp suggests a plan (project folders, screenshots by month, an Archive), you approve it once, and she does it. Nothing is overwritten or thrown away unless you ask.
• Arrange windows. “Chrome on the left, Slack on the right,” “Tidy my windows,” or “Move Spotify to my other screen.”
• Read files. “Sum up the report in Downloads.” Wisp reads documents, spreadsheets, slides, PDFs and pictures right where they are, without opening them on your screen.
• Read links. Copy a link and say “What's this about?” She reads it in the background. (Pages that need a sign-in can't be read this way.)
• Copy things for you. “Copy that address” puts it on your clipboard, ready to paste.
• Show pictures. When a picture helps, Wisp shows a little slideshow of what she's talking about. Turn it off with Show pictures of what Wisp talks about.
• Sketch. “Draw me a diagram of how our team works.” Wisp draws on a sketchpad, and each drawing is saved to Pictures/Wisp Drawings.

Building software

Describe an app, game, or tool, and Wisp builds it for you.

1. Say something like “Hey Wisp, build me a budget tracker.”
2. A build panel opens beside Wisp with a checklist of steps and a live preview.
3. When it's done, Wisp opens the finished result for you.

You can keep giving Wisp other tasks while a build runs, and you can run more than one at a time. Everything you've built lives in the Projects window, where you can open it, ask for a change, see its history, or start a new project.

Voice and language

Voices

Wisp speaks with a light, shimmering fairy voice. Change it any time: say “Hey Wisp, change your voice”, or open her menu and choose Voice.

• ElevenLabs voices are lifelike and premium (Jessica is the default). Natural voices run on your computer and are always free.
• Turn Fairy effect off for a plain voice, or choose Back to the fairy voice to return to her original sound.
• With your own ElevenLabs key, you can pick from your own voice library too.

Language practice

Wisp can be your conversation partner in another language. In her menu, turn on Understand any language so she understands what you say in other languages, and Language practice so she answers in a voice that can speak them.

• Start speaking in the language you're learning, and Wisp follows along.
• Ask for help any time: “How do I say this more naturally?” or “Correct my mistakes as we go.”

Live mode

In Live mode, Wisp keeps half an eye on your screen as you work and chimes in to help. Ask “What's this error mean?” or “Which of these flights is cheaper?” without explaining what you're looking at.

• Say “Hey Wisp, go live” to turn it on, and “Stop watching” to turn it off. Or use Live mode in her menu.
• On a Mac, Live mode uses Screen Recording if you've allowed it. If not, you'll pick which window she can see.
• Wisp only watches while Live mode is on. To keep her from looking at your screen at all, turn off Let Wisp see my screen when asked.

Work style and undo

Ask permission mode

Choose how much Wisp checks with you before acting, under Ask permission mode in her menu:

• Off: just do it (default): Wisp acts right away, batching steps together so things get done fast.
• Only for clicks, typing and closing: she asks before working your apps for you, and before things like sending email or messages, deleting events or inviting people.
• Ask every time: she checks with you before she does anything.

Background or manual

By default, file and desktop jobs happen quietly in the background. Under File jobs, choose Manual to watch Wisp fly around and do it step by step on screen.

Personality

Tell her how you like things, such as “Keep your answers short” or “Be more playful.”

Undo and What Wisp did

Changed your mind? Say “Undo that” or “Put it back” and Wisp undoes everything from your last request. Open What Wisp did from the menu or bag to see every action from the last 14 days and undo any of them one at a time. Some things can't be taken back, like sent emails and messages.

Games and play

Need a break? Wisp loves to play. Say “Wanna play chess?” or tell her you're bored, or open the bag and look under Play. To stop any game, press Esc, click Done, or tell her you're finished. She remembers your record against her.

Board and card games

Choose Board and card games with Wisp in her menu, or just ask for one: chess, checkers, Connect Four, Reversi, backgammon, mancala, Battleship, dots and boxes, gin rummy, Crazy Eights, Go Fish or tic-tac-toe. The game is laid out on a table on your screen, your pieces are at the bottom, and on her turn Wisp flies over and moves her own.

Tennis

It's you against Wisp. Your mouse is your racket on the bottom half of the screen, and she flies around the top half with a little racket of her own.

• Click or press Space to serve.
• Hold your racket still to block the ball back, swing up through it to hit harder, or swing sideways to add curve.
• It's scored like real tennis (15, 30, 40, deuce), and the first to win two games takes the match.
• Wisp gets tougher when you're winning and eases off when you're not.

Fetch

• Hold the mouse button, swing, and let go to throw Wisp's little star. It bounces off the edges of your screen, and she zooms after it and brings it back.
• Pretend to throw without letting go, and she might fall for it once or twice.
• Fetch keeps going until you stop, and she keeps count of her catches.

Pinball

Wisp is the ball. Press Space to launch, and use the Shift keys or mouse buttons to work the flippers.

The farm

Choose Farm with Wisp and a little farm appears along the bottom of your screen. It keeps growing even while it's put away, Wisp hangs out there when she's idle, and you can knock on the cottage to call her out. Drag it anywhere you like.

Playing with Wisp herself

Rub your cursor over her for a couple of seconds and she'll giggle. Grab her and shake her hard and she gets dizzy.

Common tasks

You don't need special commands. Talk to Wisp the way you'd ask a friend. Here are some ideas to get started.

Tips for great results

• Be specific. “Find a 10-minute beginner yoga video” works better than “yoga.”
• Ask for several things at once. “Close my browser tabs, mute notifications, and open my notes.” Wisp does them together.
• Correct her once. When she gets something wrong, tell her how you like it. She'll save it as a skill.
• Connect your apps. The more she can see, the better her briefs, answers and documents get.
• Curious what she's doing? Tap her thought bubble, or switch File jobs to Manual and watch her work.