Nyxo Builds is a VS Code extension for managing Docker image builds through the Nyxo Build Server. It auto-discovers repositories in your workspace, analyzes git changes with AI, and lets you selectively trigger builds — all from the VS Code sidebar.

Features

🔐 Authentication

Sign In — Email + password login directly against the Nyxo Build Server
Sign Up — Create a new account from within VS Code
Sign In via Browser — Device-code flow as a fallback
Automatic token refresh — no manual re-authentication needed
Tokens stored securely in VS Code's SecretStorage

📂 Auto-Discover Repositories

Scans every workspace folder (and all subdirectories) for Git repositories and registers them with the build server:

Recursively finds .git directories up to 5 levels deep
Skips node_modules, .venv, __pycache__, dist, .next, and other common directories
Registers each repo with its remote URL and local path
Run manually via the Auto-Discover button or automatically after sign-in

🧠 AI-Powered Analysis

Select a repository and click Sync & Analyze to:

Detect changed files since the last build
Identify which Docker images are affected and need rebuilding
Generate an AI-powered summary of changes (via DeepSeek)
View the full analysis in an output channel

🐳 Selective Builds

Check individual Docker images to include in a build
Click Build Selected Images to trigger a build on the server
Build all images if none are selected
Track build status and version tags

Each workspace repo shown with its last commit hash
Expand to see all Docker images defined in its build config
Checkbox selection for which images to build
Status indicators and tooltips for quick reference

Getting Started

Install the extension from VS Code
Click the Nyxo Builds icon in the activity bar
Click Sign In and enter your Nyxo Build Server credentials
- Don't have an account? Click Sign Up (Create Account)
Repos are auto-discovered after sign-in
Click Sync & Analyze on a repo to see what changed
Check the images you want to build, then click Build Selected Images

Configuration

Setting	Default	Description
`nyxoBuilds.serverUrl`	`https://build.nyxo.co.za`	Base URL of the Nyxo Build Server API
`nyxoBuilds.buildServerUrl`	`https://build.nyxo.co.za`	Alias for `serverUrl`

Commands

Command	Description
`Nyxo Builds: Sign In`	Sign in with email + password
`Nyxo Builds: Sign Up (Create Account)`	Create a new account
`Nyxo Builds: Sign In via Browser`	Sign in using browser-based device flow
`Nyxo Builds: Sign Out`	Sign out and clear stored tokens
`Nyxo Builds: Auto-Discover Workspace Repos`	Scan workspace for Git repos
`Nyxo Builds: Sync & Analyze`	Analyze git changes for a repo
`Nyxo Builds: Build Selected Images`	Trigger a build on the server
`Nyxo Builds: Open Dashboard`	Open the build server web UI
`Nyxo Builds: Refresh`	Refresh the sidebar tree

Requirements

VS Code ^1.85.0
Nyxo Build Server running at the configured serverUrl
An active account on the build server (create one via Sign Up)

Building from Source

git clone https://github.com/connorhess/nyxo-build-vscode.git
cd nyxo-build-vscode
npm install
npm run compile

To package a .vsix:

npx vsce package --no-dependencies

Or use the built-in bump-and-build script:

node scripts/bump-version.js patch   # 0.2.x → 0.2.(x+1)
node scripts/bump-version.js minor   # 0.2.x → 0.3.0
node scripts/bump-version.js major   # 0.2.x → 1.0.0