Skip to main content

VS Code Extension

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​

The extension is published under the AlgoshredTechnologies publisher when a release is cut; if it is not yet visible in the VS Code Marketplace for your VS Code version, sideload a local build:

git clone https://github.com/algoshred/fluidgrids-code-extension.git
cd fluidgrids-code-extension
bun install
bun run build

Then press F5 to launch the Extension Development Host.

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
}

Build​

bun install
bun run build          # production webpack build
bun run build:dev      # development build
bun run dev            # watch mode

Test​

bun run compile        # compile src
bun run compile:test   # compile tests
bun run lint           # ESLint
bun run typecheck      # tsc --noEmit
bun run test           # full VS Code extension-host test suite
bun run smoke:build    # verify build artifacts exist and are non-empty
bun run sanity         # all checks

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.

CommandWhat it does
FluidGrids: Sign InPrompt for username and password
FluidGrids: Sign OutClear stored tokens
FluidGrids: Create WorkflowCreate a new workflow
FluidGrids: Create CredentialCreate a new credential
FluidGrids: Test ConnectionTest connectivity to the gateway
FluidGrids: Open SettingsOpen the extension settings
FluidGrids: Open DashboardOpen the web app for the active environment
FluidGrids: Show LogsOpen the FluidGrids output channel
Refresh Workflows / Refresh Runs / Refresh Nodes / Refresh CredentialsReload the matching tree view
Open Workflow / Edit Workflow / Delete WorkflowManage a workflow from the Workflows view
Trigger WorkflowRun a workflow
Publish Workflow / Duplicate WorkflowPublish or duplicate a workflow
View Run Details / View Run LogsInspect a run from the Runs view
Cancel Run / Retry RunCancel a running workflow or retry a failed run
View Node Details / Insert Node into WorkflowBrowse and add nodes
Edit Credential / Delete CredentialManage 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.
  • Build/dev issues — run bun install && bun run sanity in the repo root.
  • Logs — View > Output > FluidGrids for extension host logs.

Source​

  • Repository: github.com/algoshred/fluidgrids-code-extension
  • Published on the VS Code Marketplace

Next steps​