Skip to main content

Getting Started

Configuration - flocker.md Docs

Learn how to install and set up Agent Worktree Trace.

Configure via VS Code Settings (search for “Agent Worktree Trace”):

SettingDefaultDescription
Enable File DecorationsenabledShow decoration (W) on files touched by agents
Track Uncommitted ChangestrueTrack uncommitted worktree changes (*)
Show Local Edit WarningtrueShow warning (!) if a file has been edited locally
Scan Interval Seconds60Seconds between worktree checks
Worktree Patternworktree-agent-*Glob pattern to match agent worktree directory names
Comparison BranchcurrentBranch to compare agent worktree changes against

Custom Worktree Patterns

If your agent worktrees follow a different naming convention, update the pattern in settings:

{
  "agentWorktreeTrace.worktreePattern": "agent-work-*"
}

The pattern supports * (matches any characters) and ? (matches single character).

Next Steps