[Spec 0602] VS Code Extension for Codev Agent Farm#656
Merged
waleedkadous merged 8 commits intomainfrom Apr 5, 2026
Merged
Conversation
Comprehensive SPIR spec for integrating Codev Agent Farm into VS Code. Covers: terminal integration via Pseudoterminal + WebSocket, Work View TreeView, status bar, Command Palette commands, file link handling, review comments via Comments API, shell terminals, needs attention, cloud tunnel status, team view, cron tasks, and analytics Webview. Includes shared package extraction strategy (codev-types, codev-api-client) and expert consultation from Gemini 3 Pro and GPT-5.1 Codex.
- Rename all af references to afx (Spec 647) - Update version from v1.x to v3.x - Add .codev/config.json layered config system - Add forge-agnostic language (GitHub/GitLab/Gitea support) - Add afx spawn --branch support to Spawn Builder command - Add author attribution (@username) to TreeView items (Spec 637) - Add EscapeBuffer for incomplete ANSI sequences across WS frames (Bugfix #630) - Add resize deferral during replay (Bugfix #625) - Document workspace-scoped vs global API routes in Connection Manager - Add SSE heartbeat handling (Bugfix #580) - Expand references with Specs 618, 627, 637, 647
- Architect terminal opens as a side editor (full vertical height) via workbench.action.terminal.moveIntoEditor + vertical split - Builders/shells stay in the bottom terminal panel - Merge UX walkthrough (browser vs VS Code comparison) into the spec - Delete standalone walkthrough file
…Claude)
Critical fixes:
- TextDecoder must use { stream: true } for multi-byte Unicode safety
- Review comments use WorkspaceEdit, not Tower fs.writeFileSync endpoint
- Never drop PTY frames — disconnect and reconnect via ring buffer
- WebSocket auth via control message, not query param (prevents log leaks)
Architecture changes:
- Architect editor-split opt-in with panel fallback (undocumented API risk)
- Auth key re-read from disk on 401 for rotation handling
- Workspace path traverses up to .codev/config.json root
- Shared package extraction phased (types before V1, API client after)
- Monorepo workspace prerequisite noted
New sections:
- Error Handling UX
- Extension Settings schema (6 settings)
- Default Keyboard Shortcuts
- Output Channel for diagnostics
- Promote afx open URI scheme to Critical open question
waleedkadous
previously approved these changes
Apr 3, 2026
- Extension runs afx tower start as detached process if Tower not responding - Never auto-stops Tower — daemon outlives VS Code so builders keep running - Add codev.autoStartTower setting (default: true) - Resolve open question: auto-start vs manual start
Architect in left group (1 tab), builders + shells in right group (N tabs). Replaces bottom panel layout. Update diagrams, settings, and walkthrough to match.
Propose consolidating Work View, Team, and Status into a single sidebar container with collapsible sections. Includes full-width layout diagram showing sidebar, architect, and builder groups.
V1: snippet/command to insert REVIEW comments + Decorations API to highlight existing ones visually. Post-V1: full Comments API with gutter buttons and threading.
waleedkadous
approved these changes
Apr 5, 2026
Contributor
waleedkadous
left a comment
waleedkadous
left a comment
There was a problem hiding this comment.
Approved! Love the codev sidebar idea. On board with everything.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
packages/codev+packages/codev-vscode)Key Decisions
Commits
Spec
Infrastructure
packages/codev-vscode/)Ref #602
Test plan
npm run buildin packages/codev still passesnpm testin packages/codev still passes (2422 tests)