DocsGet started

Add repositories

Add your local git repositories to Whaatcher. Whaatcher finds their worktrees and starts code analysis in the background.

Add a repository

  1. On the Dashboard, click Add Repository (+) in the toolbar.
  2. Select the repository's top-level folder, or hold ⌘ to select several.
  3. Click Open.

Each repository you add appears on the Dashboard as a card. An empty Dashboard also shows this button in the middle of the window. Folders that aren't git repositories, and repositories already on the Dashboard, are skipped.

If a repository is inside a protected folder such as Documents or Desktop, macOS may ask whether Whaatcher can access it; allow it.

Worktrees are found for you

You don't add worktrees one by one: Whaatcher reads the repository's worktree list and shows every worktree on its card. When you or an agent create or remove a worktree later, the card updates by itself. To see how worktrees open as tabs, read Repositories and worktrees.

Code analysis starts in the background

As soon as you add a repository, Whaatcher starts analyzing its code in the background. Repositories are analyzed one at a time, newest addition first. You can keep working meanwhile, and if you quit, it resumes where it stopped. Until it finishes, analysis views show Analysis pending, and the top of the repository's Overview shows progress.

Analysis follows one branch per repository, the Analyzed Branch. By default that's develop if it exists, then main or master, then the branch checked out in the main worktree. To pick another branch or turn analysis off for a repository, see Code Analysis.

Whaatcher keeps its own data out of your repository; the analysis lives in ~/Library/Application Support/Whaatcher.

Manage a repository from its card

Right-click a repository's card on the Dashboard to open its menu.

  • Reveal in Finder shows the repository's folder in Finder.
  • Refresh reads the repository's git state again.
  • Remove takes the repository off the Dashboard.

Cards follow file changes on their own, so use Refresh only when one looks out of date. Press ⌘R on the Dashboard to refresh every repository at once.

Removing closes the repository's tabs and deletes its code analysis, but the folder itself stays untouched. If a terminal in those tabs is still running something, Whaatcher asks first, and Cancel keeps the repository. If you add it again later, its code analysis starts over from the beginning.

To read what a card shows, see Dashboard.