VS Code Extension

Roadmap

The FluidGrids VS Code extension is not yet available on the Visual Studio Marketplace. This page describes the planned extension. Until it ships, use the CLI in VS Code's terminal, or the MCP server with an assistant in your editor.

FluidGrids brings workflow management, run monitoring, node browsing, and credential management into VS Code so you never leave your editor.

Features

• Workflow Management — create, edit, delete, duplicate, trigger, and publish workflows
• Run Monitoring — view run history, logs, cancel running workflows, retry failed runs
• Node Browser — explore available nodes by category, view documentation
• Credential Management — securely manage API keys, OAuth tokens, and other credentials
• Dashboard — open the FluidGrids web dashboard for the active environment
• Real-time Updates — auto-refresh with configurable intervals
• Secure Authentication — username/password sign-in with secure token storage

Install

Not available yet. It will be installed from the Visual Studio Marketplace.

Environment selection

The extension resolves GraphQL endpoints and dashboard URLs from BURDENOFF_ENV:

BURDENOFF_ENV=local   # http://127.0.0.1:4003 / http://127.0.0.1:4000
BURDENOFF_ENV=alpha   # alphagraphqlworkspaces / alphagraphql / alphaapp.fluidgrids.ai
BURDENOFF_ENV=prod    # graphqlworkspaces.burdenoff.com / graphql.burdenoff.com (default)

When BURDENOFF_ENV is unset or invalid, the extension defaults to prod so an installed build works without configuration.

VS Code settings under fluidgrids.* override the env-derived defaults:

{
  "fluidgrids.apiUrl": "",
  "fluidgrids.graphqlUrl": "",
  "fluidgrids.autoRefresh": true,
  "fluidgrids.refreshInterval": 30,
  "fluidgrids.showNotifications": true
}

Commands

Command titles use the FluidGrids: category prefix only for a few top-level actions; the rest are contextual commands invoked from the tree-view item menus.

Command	What it does
FluidGrids: Sign In	Prompt for username and password
FluidGrids: Sign Out	Clear stored tokens
FluidGrids: Create Workflow	Create a new workflow
FluidGrids: Create Credential	Create a new credential
FluidGrids: Test Connection	Test connectivity to the gateway
FluidGrids: Open Settings	Open the extension settings
FluidGrids: Open Dashboard	Open the web app for the active environment
FluidGrids: Show Logs	Open the FluidGrids output channel
Refresh Workflows / Refresh Runs / Refresh Nodes / Refresh Credentials	Reload the matching tree view
Open Workflow / Edit Workflow / Delete Workflow	Manage a workflow from the Workflows view
Trigger Workflow	Run a workflow
Publish Workflow / Duplicate Workflow	Publish or duplicate a workflow
View Run Details / View Run Logs	Inspect a run from the Runs view
Cancel Run / Retry Run	Cancel a running workflow or retry a failed run
View Node Details / Insert Node into Workflow	Browse and add nodes
Edit Credential / Delete Credential	Manage a credential from the Credentials view

Troubleshooting

• Tree views empty after sign-in — run the matching Refresh command (e.g. Refresh Workflows); if still empty, sign out and sign in again to re-mint the token.
• Logs — View > Output > FluidGrids for extension host logs.

Next steps

• Browser Extension
• CLI Reference
• Node SDK