Repository navigation
Scan roots
cloudranger edited this page Nov 14, 2026
·
1 revision
zap scan --all, zap clean --all, zap check and zap map search your scan roots for repositories.
zap roots
The defaults are ~/dev, ~/code, ~/src and ~/projects, plus the folders agents keep worktrees in outside your repositories: ~/.codex/worktrees, ~/.cursor/worktrees, ~/conductor/workspaces and ~/.t3/worktrees. zap skips folders that don't exist.
zap roots add ~/work ~/clients # search these too
zap roots remove ~/src # stop searching here
zap roots reset # back to the defaultsInside a repository, zap scan and zap clean without --all only look at that repository, whatever your roots are.
Getting started
Using zap
- The picker
- How zap decides
- Safety checks
- The .zap file
- Scan roots
- Disk alerts
- What agents keep on disk
With coding agents
Reference