VS Code Extension for Codev Agent Farm

[amrmelsayed]

Summary

VS Code extension (codev-vscode) that acts as a thin client to Tower's existing API, bringing the Agent Farm dashboard experience natively into the IDE.

Key Components

• Native terminals (Pseudoterminal + WebSocket)
• Work View sidebar (TreeView)
• Status bar (builder count, blocked gates)
• Command Palette (afx/porch commands)
• File link handling (afx open)
• Review comments (Comments API, interoperable with browser dashboard annotations)
• Analytics Webview (Recharts)
• Connection resilience (reconnection, degraded state)

Spec

codev/specs/0602-vscode-extension.md

Approach

Thin client extension (Approach 1) — all state stays in Tower/shellper. Native VS Code UI for operational controls, Webview only for analytics.

Open Questions

• Monorepo vs separate repo → Monorepo (packages/codev-vscode/)
• afx open URI scheme vs filesystem watcher
• Auto-start Tower or require manual start
• Terminal naming convention

---

Spec: 0602
Protocol: SPIR