DGx VS Code Extension
Connect your VS Code to DecisionGraph and orchestrate work through Claude Code, Codex, or any other coding agent with automated status synchronization.
Features
- Google OAuth and email/password login with secure credential storage
- Client selection for multi-client workspaces
- Plan View — full work item hierarchy (Products, Features, Initiatives, Epics, Stories, and more)
- Story selection with visual indicators, search, and saved filter presets
- Start a session with one command — puts a ready-to-paste prompt on your clipboard
- Local API server so your coding agent can fetch story details and sync status automatically
- Code View — monitor story progress in real time during a session
- QA View — review and certify completed stories against acceptance criteria
- Deep Review — multi-group code review with findings synthesis
- Manifest Search — right-click any file to find every story that touched it
- Mockup branches — scaffold a prototype branch with a session file and auto-launch
- Session persistence across VS Code restarts
Getting Started
Install from the VS Code Marketplace, then:
- Open the Command Palette (
Cmd+Shift+P / Ctrl+Shift+P)
- Run
DGx:Login — sign in with Google or email/password
- Run
DGx:Select Client to choose your workspace
That's it. The local API server starts automatically. No configuration needed for standard use.
Click the DGx icon in the Activity Bar to open the control panel. It has four panels:
| Panel |
What it does |
| Plan View |
Browse the full work item hierarchy. Select stories, search, filter, and launch sessions. |
| Code View |
Monitor an active session — current story, completed, blocked, remaining. |
| QA View |
Review stories ready for certification. Run QA review against acceptance criteria. |
| Manifest Search |
Find every story that touched a file. Works without an active session. |
Workflows
Browse & Select Stories
- Open the DGx sidebar and expand Plan View
- Browse the hierarchy — Products, Features, Initiatives, Epics, Stories
- Click any story to select it (checkmark appears); click again to deselect
- Use
DGx:Search Work Items to filter by keyword
- Save common selections as filter presets with
DGx:Save Filter Preset
Start a Work Session
- Select the stories you want to build in Plan View
- Click the ▶ Play button in the Plan View toolbar (or run
DGx:Play (Create + Launch))
- DGx creates a session file and puts a start-work prompt on your clipboard
- Paste the prompt into Claude Code (or your preferred agent) to begin
Your agent uses the local API at http://localhost:3847 to fetch story details and sync status as it works. You don't need to manage this — it runs automatically in the background.
Monitor & Complete a Session
- Watch Code View for live progress: current story, completed, blocked, remaining
- Run
DGx:Show Session Summary for a snapshot at any time
- Click ■ Stop or run
DGx:Stop Work Session to end the session
QA Review
- When stories reach the review stage, open QA View
- Select the stories to certify
- Run
DGx:Play QA Review — puts a batch certification prompt on your clipboard
- Paste into your agent; it checks each story against its acceptance criteria
Deep Review
For a structured multi-pass code review:
- Run
DGx:Start Deep Review to initialize a review session
- Work through review groups with
DGx:Run Next Group Review
- When all groups are done, run
DGx:Run Synthesis Pass to consolidate findings
- Export with
DGx:Export Review as Markdown
Find Stories by File (Manifest Search)
Right-click any file in the Explorer and choose Show DG History — the Manifest Search panel opens and instantly shows every story that touched that file. You can also type a path directly into the Manifest Search panel. Works without an active session.
Settings
For most users, no settings changes are needed. Advanced options:
| Setting |
Default |
Description |
dgx.apiUrl |
https://decisiongraph.io |
API URL — leave as default unless directed otherwise |
dgx.localApiPort |
3847 |
Port for the local API server |
dgx.autoStartLocalApi |
true |
Start local API automatically on activation |
dgx.agentCommand |
claude |
Agent to launch for mockup branches (claude, cursor, etc.) |
dgx.mockupBranchPattern |
mockup/{id}-{slug} |
Branch naming for mockup branches |
dgx.repositoryRoots |
[] |
Local directories to scan when resolving a repository URL to a local path |
Troubleshooting
Cannot connect to DecisionGraph
- Check your internet connection and try again
- Run
DGx:Logout then DGx:Login to refresh your credentials
Port 3847 already in use
- Change
dgx.localApiPort to an open port and restart VS Code
Authentication fails
- Run
DGx:Logout then DGx:Login again
- For Google login, make sure your browser can complete the OAuth redirect
Requirements
