Skip to content

The desktop app

The desktop app is wisp in its own window. It is the same wisp as in the browser and on your phone: one small local server, wisp serve, and one UI. The window adds what a browser tab can’t do well.

Install it

Pick the line for your computer.

Computer Get it
macOS 13.3 or later brew install --cask wispagents/tap/wisp, or curl -fsSL https://trywisp.dev/install.sh | bash -s -- --app
Windows wisp-windows-<arch>-setup.exe from the latest release
Linux the .AppImage or the .deb from the latest release (glibc 2.35 or later)

The release also has SHA256SUMS.txt, to check what you downloaded. On macOS, --app checks it for you and puts wisp in your Applications folder.

Installed wisp with npm? You don’t need a separate download on macOS or Windows: wisp desktop fetches the small window once, checks it against the release, and opens it. On Linux it opens a browser tab for now.

Open it

Open wisp from your Applications folder, Start menu or app launcher. It starts its server and shows your tasks. Open it again and you get the same window: there is only ever one. ⌘K (Ctrl-K on Windows and Linux) finds any task, command or setting.

In the browser (wisp --browser, or your cloud wisp) it’s the same window, menus and keys.

The ⌘K search and commands box open over the desktop app, listing tasks and commandsThe ⌘K search and commands box open over the desktop app, listing tasks and commands

What the window adds

  • A badge on the Dock or taskbar icon with how many tasks need you.
  • System notifications when a task finishes or asks. Click one to go straight to that task.
  • Your shell’s PATH. Started from the Dock or Finder, the app still finds claude, codex and the rest.
  • Links open in your browser, and the window keeps wisp.
  • Menus and keys: Reload (Cmd/Ctrl-R), zoom (Cmd/Ctrl-=, -, 0), full screen.
  • Closing the window: on macOS your agents keep running and the app stays in the Dock. On Windows and Linux, closing the window quits wisp and stops its server.

Updates

The app updates itself. When a new version is out, its top bar shows Update to ….

Press Update to … in the top bar, or open the person button → Settings → Updates: pick a channel (Stable, Beta or Nightly), Check now, then Update now. wisp restarts; running tasks are stopped, and it says how many first.

Next