NexCode Extension (MVP)

NexCode is a VS Code extension prototype implementing the PRD baseline plus the new repository-persisted graph feature.

Implemented in this MVP

• Initial graph generation into ./.nexcode/graph.json
• Graph rescan command for full rebuild
• Automatic graph refresh on file save (when enabled)
• Graph deletion command (Delete Graph) for cleanup before push
• Git mode setting:
  • track (default): keep .nexcode as commit-able repository data
  • ignore: auto-add .nexcode/ to .gitignore
• Graph status command to verify current indexing state
• Sidebar panel in Activity Bar with one-click graph actions
• Graph-aware context preview command for write/explain prompt routing
• write_code flow with prompt + target path + diff preview before apply
• explain_code flow for active file or selection to markdown output
• run_code flow for active .js, .ts, .py, .ps1 files via terminal

Commands

• NexCode: Generate Graph
• NexCode: Rescan Graph
• NexCode: Delete Graph
• NexCode: Toggle Graph Mode
• NexCode: Graph Status
• NexCode: Preview Graph Context
• NexCode: Write Code
• NexCode: Explain Code
• NexCode: Run Code

Sidebar

• Open the NexCode icon in the Activity Bar.
• Use buttons to generate/rescan/delete graph and preview context payload.
• Status card shows enabled state, graph presence, file/edge counts, and last update timestamp.

Settings

• nexcode.graph.enabled (boolean, default: true)
• nexcode.graph.gitMode (track | ignore, default: track)
• nexcode.graph.maxFiles (number, default: 300)

Develop

1. Open this folder in VS Code.
2. Press F5 to run Extension Development Host.
3. In the dev host window, run commands from the command palette.

Quick Git Workflows

Keep graph and push

git add .nexcode
git commit -m "Add NexCode persisted graph"
git push

Remove graph and push clean

Remove-Item -Recurse -Force .\.nexcode
git add -A
git commit -m "Remove NexCode graph artifacts"
git push

Publish to VS Code Marketplace

1) Prerequisites

• Create a Visual Studio Marketplace publisher account.
• Install vsce globally.

npm install -g @vscode/vsce

2) Verify extension metadata

In package.json, confirm:

• name
• displayName
• publisher (must match your Marketplace publisher ID)
• version (increment for each release)

3) Login and publish

Generate a Personal Access Token in Azure DevOps (Marketplace publish scope), then run:

Set-Location "C:\Users\karth\nexcode-extension"
vsce login <your-publisher-id>
vsce package
vsce publish

4) Publish a specific version

vsce publish patch

Use minor or major instead of patch when needed.