DocsGet started

Install Whaatcher

Whaatcher needs macOS 26 or later and git. This page shows how to install it and which prompts you may see.

System requirements

  • macOS 26 or later
  • git from Apple's Command Line Tools or Xcode

To check for git, open the Terminal app and run git --version. If the tools aren't installed, macOS offers to install them.

Install from the DMG

Whaatcher comes as a DMG disk image, signed by its developer and notarized by Apple.

  1. Download the Whaatcher DMG.
  2. Open the downloaded file, Whaatcher-<version>.dmg.
  3. In the window that opens, drag Whaatcher onto the Applications folder.
  4. Eject the disk image, then open Whaatcher from your Applications folder.

Prompts you may see

Whaatcher runs outside the App Sandbox so it can run git in your repositories and start your shell. It doesn't ask for Accessibility, screen recording, or Full Disk Access. macOS may still ask in the cases below.

When you first open Whaatcher, macOS asks whether you want to open an app downloaded from the internet. Apple has notarized Whaatcher, so click Open.

If a repository is in a protected folder such as Documents, Desktop, or Downloads, macOS asks whether Whaatcher can access files in that folder. Click Allow so Whaatcher can read the repository. Programs you run in a Whaatcher terminal, such as coding agents, can bring up the same prompt. If you denied access, turn it on for Whaatcher in System Settings › Privacy & Security › Files & Folders.

Whaatcher keeps the tokens you add in Settings › Accounts in your macOS Keychain. If macOS asks whether Whaatcher can use an item in your keychain, enter your Mac login password and click Always Allow.

If your SSH agent asks before each use of a key, as 1Password or Secretive can with Touch ID, its prompt can appear when the Graph of a repository with an SSH remote opens. This happens because Whaatcher checks which remote branches still exist. HTTPS remotes and agents that don't ask aren't affected.

Next steps

Whaatcher first opens to an empty Dashboard. Add repositories shows how to add your local git repositories with Add Repository. Run an agent shows how to start a coding agent so its sessions are recorded. Supported agents and hosts lists the coding agents and code hosts Whaatcher works with.