# Waku

A native desktop app that brings coding-agent sessions, transcripts, tool activity, and checkpoints together on your Mac.

> This is the Markdown version of the Waku page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/waku>

- **Latest version**: `0.1.20`
- **Developer**: xinyu zeng
- **Homepage**: <https://waku.sh/>
- **Categories**: [Developer Tools](https://opennavo.com/categories/developer-tools)
- **Install**: `brew install --cask waku`
- **30-day installs**: 9
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://github.com/egoist/waku/releases/download/v0.1.20/Waku-0.1.20.dmg>
- **SHA-256**: `b01d0cbc3cc6f4e4717d4be56e2f58b46114ad2f9439cf28a228e4a7585e53ce`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "quit": "sh.waku"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "app": [
        "Waku.app"
      ],
      "target": "/Applications/Waku.app"
    },
    "phase": "install",
    "sources": [
      "Waku.app"
    ],
    "target": "/Applications/Waku.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/.waku",
            "~/Library/Application Support/sh.waku",
            "~/Library/Application Support/Waku",
            "~/Library/Caches/sh.waku",
            "~/Library/Caches/Waku",
            "~/Library/HTTPStorages/sh.waku",
            "~/Library/Preferences/sh.waku.plist",
            "~/Library/Saved Application State/sh.waku.savedState"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Waku is a native desktop app for working with coding agents. It drives agent CLIs and brings sessions, transcripts, tool activity, and checkpoints together in one window. The app runs on your machine, with project and session data stored locally.

- Connects to agents through their native interfaces and presents activity in a provider-neutral format.
- Creates a checkpoint of your working tree for each prompt, so you can roll back code and the associated agent conversation together.
- Provides keyboard controls for starting sessions, queuing follow-ups, steering an agent mid-turn, and stopping it.
- Uses a native interface built with Rust and GPUI; the publisher describes it as GPU-accelerated and says it is not an Electron app.
- The publisher says the app updates automatically using Sparkle and binary deltas.

Install with `brew install --cask waku`, then open Waku from Applications. The Homebrew cask requires an Apple silicon Mac running macOS 13 or later. Waku is an app for operating coding-agent CLIs; it does not replace them. The publisher says no Waku account or Waku cloud service is needed.

Sources: [Waku](https://waku.sh/), [Homebrew cask](https://raw.githubusercontent.com/Homebrew/homebrew-cask/HEAD/Casks/w/waku.rb)

## System requirements

- macOS 13 or later · Version: 0.1.20 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/waku.rb> · Checked 2026-11-22
  - <https://github.com/egoist/waku/releases/download/v0.1.20/Waku-0.1.20.dmg>
  - SHA-256: `b01d0cbc3cc6f4e4717d4be56e2f58b46114ad2f9439cf28a228e4a7585e53ce`

## Waku security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/egoist/waku> · Open source: Yes — <https://github.com/egoist/waku> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask waku`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask waku`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/.waku` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/waku.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/sh.waku` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/waku.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/Waku` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/waku.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/sh.waku` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/waku.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/Waku` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/waku.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/HTTPStorages/sh.waku` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/waku.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/sh.waku.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/waku.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Saved Application State/sh.waku.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/waku.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 0.1.20 (2026-10-02)

Adds OpenCode 2.0 support and fixes for OpenCode, Cursor model discovery, Pi startup, and long messages. Claude model names now show their release version, and the project picker is searchable and scrollable.

**OpenCode**

- Adds support for OpenCode 2.0 and its shared background service.
- OpenCode 2 beta and OpenCode 1 tasks continue as OpenCode tasks.
- Fixes incorrect task branching and turns interrupted by service restarts.

**Models**

- Cursor pickers now show every CLI-advertised model and its options.
- Claude model names now include the release version.

**Interface**

- Project picker is searchable and scrollable; key actions stay pinned.
- Fixes Pi startup when extension loading is slow.
- Long user messages scroll inside their bubbles.

## Facts and sources

- <https://opennavo.com/apps/waku>
- <https://opennavo.com/apps/waku/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/waku.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/waku>
- <https://github.com/egoist/waku> · Checked 2026-11-13
