Echolot — Azure DevOps PR reviews inside VS Code
Fast, AI-assisted pull request reviews for Azure DevOps with one-click worktrees, size-aware cues, and smart filters.
Install
- VS Code Marketplace: search “Echolot” (or install a
.vsix build).
- Reload VS Code after install.
Prerequisites
- Azure CLI (
az) for sign-in (install)
- Git 2.20+ for worktree operations
- A VS Code workspace that is a single Azure DevOps Git repo
First-time setup
- Echolot offers a setup wizard when required settings are missing; if your settings are already valid the wizard is skipped.
- Steps:
- Sign in with
az login when prompted.
- Enter your Azure DevOps organization (e.g.,
contoso).
- Select the project(s) to monitor.
- Choose a worktree parent directory (default:
~/.echolot/worktrees).
Daily workflow
- Open the Echolot view (PR icon in the Activity Bar).
- Browse assigned PRs with T-shirt sizing (XS–XL); large PRs prompt before creating worktrees.
- Select a PR → Open in Worktree to review in an isolated window.
- Use the PR detail view to see files, diffs, reviewers, and linked work items.
- Submit your review (approve/reject/wait) and sync back to Azure DevOps.
Commands and shortcuts
Echolot: Open PR in Worktree (Enter on a PR)Echolot: Refresh Pull Requests (Ctrl+Shift+R)Echolot: Show PR DetailsEcholot: Cleanup WorktreeEcholot: Run Setup WizardEcholot: Filter by Size/Status/LabelsEcholot: Export Reviews to JSON
Key settings
Configure via VS Code Settings → Extensions → Echolot.
| Setting |
Default |
Purpose |
echolot.organization / echolot.projects |
required |
Azure DevOps scope to monitor |
echolot.worktreeParentPath |
~/.echolot/worktrees |
Where PR worktrees are created |
echolot.repoMappings |
{} |
Map Project/Repo → local path when repos live outside the workspace |
echolot.autoCleanupWorktrees |
prompt |
Cleanup policy: prompt | auto | never |
echolot.refreshInterval |
300 |
Auto-refresh cadence (seconds) |
echolot.filterBySize/status/labels, echolot.filterMyPRsOnly, echolot.hideMyOwnPRs |
— |
Control what appears in the list |
echolot.reviewExcludeGlobs |
['**/*.md', '**/*.json', '**/*.lock', '**/package-lock.json'] |
Skip files in automated reviews |
echolot.reviewLanguageInstructions |
{} |
Per-language AI review guidance (key by language or extension) |
Working with multiple repositories
- If a PR targets a repo outside your current workspace, you’ll be prompted to pick its local clone once; the path is cached in
echolot.repoMappings.
PR size bands
- XS < 50 lines, S 50–200, M 200–500, L 500–1000, XL > 1000. Large PRs warn before worktree creation.
Troubleshooting
- Azure CLI missing/expired: install CLI and run
az login.
- No workspace detected: open a folder with a single Git repo.
- No Azure DevOps remote: ensure origin is
dev.azure.com or *.visualstudio.com.
- Wizard keeps showing: fill required settings; once valid, setup is marked complete.
- Network timeouts: retry; transient failures are auto-retried.
Support
- Check the VS Code Output panel → "Echolot" for logs.
- Report issues and feature requests via the project issue tracker.
License
MIT License — see LICENSE.
Echolot — Fast pull request reviews for Azure DevOps
| |
