Manage Docker builds via Nyxo Build Server. Auto-discovers workspace repos, analyzes git changes with AI, and lets you selectively trigger builds from the VS Code sidebar.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
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
📊 Sidebar Tree View
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
