DocsConcepts

Repositories and worktrees

Whaatcher reads your code at four levels: the repository you add, its worktrees, the working tree of each worktree, and the Analyzed Branch that code analysis follows.

Repository

A repository is a git repository on your Mac that you add to Whaatcher, and each one gets a card on the Dashboard. See Add repositories.

Worktrees and tabs

A worktree is a folder made with git worktree. Worktrees of one repository share its history, but each has its own checked-out branch and files. Whaatcher finds them all by itself, including ones your agents create.

In the Workspace, each tab is one worktree and stays that worktree. Files, uncommitted changes and terminal sessions belong to the tab's worktree. Graph shows the whole repository, the same in each of its tabs.

Files or Graph on a card opens the repository's tab you viewed last, or its main worktree. Other worktrees open from the worktree menu in the toolbar, and a new worktree never opens a tab by itself. See Workspace.

Working tree

The Working tree is a worktree's uncommitted state, its files as they are on disk now. In Graph, each worktree with uncommitted changes gets an Uncommitted changes row at the top, linked to the commit that worktree has checked out. In a file's Change History, the Working tree row is the file on disk.

Analyzed Branch

Code analysis follows one fixed branch per repository, the Analyzed Branch, whatever your worktrees have checked out, so switching branches never restarts it. Overview, function history and similar functions follow it, and the Dashboard card of a repository with several worktrees measures them against it.

Whaatcher uses the first of these that exists:

  1. The branch you chose in Code Analysis settings
  2. develop
  3. main, then master
  4. The branch checked out in the main worktree

Changing it rebuilds the repository's analysis from the start.

Refresh and Reload

Whaatcher updates on its own, so you rarely need either.

  • Refresh (⌘R) reads git state and the file tree again: every repository on the Dashboard, or the Graph or Files screen you're on in the Workspace. It never changes files you have open.
  • Reload from Disk (↻ at the top of an open file) replaces the file with what's on disk now. Open files don't update by themselves; when one changes, it shows Changed on disk.