Support
Docs
How to use Whaatcher: guides, concepts and troubleshooting.
We are writing these pages. If you have a question in the meantime, write to support@whaatcher.com.
Get started
- Install WhaatcherWhat Whaatcher needs, macOS 26 or later and git, and how to install it.
- Add repositoriesAdd your local git repositories. Whaatcher finds their worktrees and starts code analysis in the background.
- Run an agentStart your coding agent in Whaatcher's terminal so its sessions, turns and tokens are recorded.
- Supported agents and hostsThe coding agents and code hosts Whaatcher works with, and what “Not supported” means on screen.
Concepts
- Repositories and worktreesRepository, worktree, working tree and analyzed branch: how Whaatcher reads your code.
- Agent sessions and turnsWhat an agent session and a turn are, and how agent active time and the time between turns are counted.
- Recorded and inferredWhat comes straight from the record, what Whaatcher works out, and how the screens tell them apart.
- TokensInput, cache and output tokens, and why output tokens are the number Whaatcher shows first.
- Cognitive complexityHow hard a function is to follow, and what the 0–14, 15–29 and 30+ tiers mean.
- Similar functionsFunctions with a similar structure, and why changing one but not the others is worth a look.
- ImpactWhat a change touched and how far, set against this repository's usual.
Screens
- DashboardEvery repository as a dial: when it last moved, what changed, and where its worktrees stand.
- WorkspaceA tab for each worktree, the agent tiles on the tab bar, and the Terminal Dashboard.
- TerminalThe terminal your agents run in: main and child terminals, status badges, and sessions that outlive the app.
- GraphThe commit graph with its branches, people, tokens and changes, and the panel for each commit.
- WorklogWhat the agent did for a commit, turn by turn and file by file.
- Pull RequestsOpen, merged and closed pull requests, and what each merge left behind.
- FilesThe file tree and viewers, and each file's outline, history and similar functions.
- OverviewWhere the code stands: hotspots, growing functions, complexity by folder and similar function groups.
- HindsightMemory, tokens, tool calls, errors and HEAD moves for every agent session on one timeline.
- InsightWhere work was redone across commits, and how agent time and tokens added up.
Settings
- AccountsConnect GitHub or GitLab to see pull requests. Tokens are kept in your Keychain.
- Code AnalysisTurn analysis on or off for each repository, choose the analyzed branch, and rebuild it.
- Impact settingsThe values Impact uses to decide what needs attention, for all repositories or for one.
- AppearanceTheme, colors, terminal theme and the app's language.
- Code BlocksRender diagrams, math and 3D models in Markdown previews.