Getting Started
Introduction - flocker.md Docs
Track files changed by AI agents working in parallel git worktrees - directly in VS Code's File Explorer.
Agent Worktree Trace is a VS Code extension that tracks and highlights files changed in local git worktrees.
When you have multiple AI agents working in parallel using git worktrees, this extension shows you which files they’ve touched directly in VS Code’s File Explorer.
What is Agent Worktree Trace?
A lightweight VS Code extension designed for parallel AI agent workflows. It monitors agent worktrees and decorates files in the Explorer, helping you:
- Track agent activity across multiple parallel worktrees (live)
- Identify potential merge conflicts before they happen
- See local changes that might conflict with agent work
File Decorations
Files touched by agents display a badge in the VS Code Explorer:
| Badge | Meaning |
|---|---|
W | 1 agent has changed this file |
W* | 1 agent has changed this file, but not committed |
W3 | More than one agent has changed this file (3 in this example) |
!W | 1 or more agents, and you, have changed this file (watch out) |
How It Works
- The extension discovers git worktrees matching your configured pattern (default:
worktree-agent-*) - For each worktree, it monitors file changes against your configured branch
- Changed files are traced and decorated in the Explorer
- Scans run periodically (configurable) and can be stopped/started from the status bar
Next Steps
Ready to get started? Head over to the Getting Started guide.