Pepewitch/wisp

Run coding agents in parallel. Keep their work separate.

Self-hosted · No Wisp account · Desktop, browser, phone, and CLI

Working on several things with coding agents usually means juggling terminals, remembering which branch belongs to which task, and checking whether an agent is finished or waiting for you.

Wisp gives each task its own Git worktree and branch, with one place to follow progress, review diffs, and send follow-up instructions. Keep using your existing Droid, Claude Code, Codex, Cursor, or OpenCode installation.

• Work in parallel without sharing a checkout. Give one agent a bug fix and another a feature. Their edits stay on separate task branches.
• Pick up where you left off. Read the conversation, inspect changes, open a terminal, or steer the next step. Tasks keep running when you close the UI.
• Use the interface that fits. Work locally in Desktop or the browser, script tasks from the CLI, and check in from your phone over a private connection.

Bring Git, a repository, and at least one installed and authenticated coding agent. Wisp itself needs no Node or Bun runtime.

brew install Pepewitch/tap/wisp Pepewitch/tap/wisp-desktop
open -a Wisp

This installs both the CLI/daemon and Desktop. Name both: Homebrew trusts only the fully qualified names you install from a non-official tap, so installing the Cask alone stops on the Formula it depends on. In the app, finish Local setup, add a repository, and create a task. For CLI-only installation and troubleshooting, see the macOS guide.

curl --proto '=https' --tlsv1.2 -fsSL \
  https://raw.githubusercontent.com/Pepewitch/wisp/v0.6.6/scripts/install.sh | sh

The installer verifies the download, installs under your home directory, and starts a systemd user service when available. It does not use sudo. For inspecting the script first, running without systemd, or fixing PATH, see the Linux guide.

With the daemon running, substitute your repository path and agent:

wisp project add /path/to/repo
wisp doctor --harness droid
wisp new /path/to/repo "Find a small bug, fix it, and run the tests." --harness droid
wisp token

Open the URL from wisp token and paste its token to follow the task in your browser. Keep that token private. wisp help lists the CLI commands.

A worktree is not a sandbox. Wisp runs agents as your OS user with their tool-approval bypass enabled. They can access files, credentials, and the network outside the task checkout. Use trusted repositories, review changes, and use a separate OS account or disposable VM for untrusted work.

Wisp is pre-1.0 and intended for single-user use. Linux release gates cover Ubuntu 24.04 x86_64; the binary requires glibc 2.17+ (no musl build). Desktop targets Apple Silicon and macOS 12.3+, with limited OS qualification. Intel Macs and Windows are unsupported. Desktop releases are signed and notarized. Publishable macOS CLI/daemon releases now use the same Developer ID trust chain and a stable dev.wisp.daemon code-signing identity inside a branded background application bundle; v0.5.13 and earlier CLI releases were unbundled and ad-hoc signed.

• CLI reference
• Task workflows: heartbeats and scheduled steers
• Auto-merge and auto-fix: merge a task's PR once it is ready, fix its red CI and review feedback
• Task briefs: an optional short report from the agent at the end of each turn
• Remote and phone access
• Storage, archive, and cleanup
• Security and vulnerability reporting
• Changelog, release notes and tested limits

Bug reports, documentation fixes, and small PRs are welcome. Start with Contributing for local setup and checks, or Architecture to understand the code.

MIT © 2026 pepewitch.