Quick Start

After install (30 seconds)

SnakeFlow does not require a cloud account. On first launch you may see a Getting Started walkthrough in the IDE.

Ctrl+Alt+F — run Quality Hub (main value; works offline).
Ctrl+Alt+M — open the Tools menu (servers, GitHub, optional cloud sync).
SnakeFlow icon in the Activity Bar — pin Quality Hub to watch results.

First Launch

Open your project in VS Code or Cursor.
Press Ctrl+Alt+M — the extension auto-detects the project name and package manager from your workspace.

Configure servers via the main menu → Manage Servers, or add them directly to .vscode/settings.json:

"devManager.project.servers": [
  { "id": "web", "label": "Frontend", "command": "npm run dev", "path": "", "port": 3000 }
]

Press Ctrl+Alt+S to start all servers marked for bulk start (startWithAll is not false). Click the server indicator in the status bar to start, stop, or restart one server (e.g. Prisma Studio with "startWithAll": false).
Open the sidebar — click the SnakeFlow icon in the Activity Bar to see Quality Hub, Workflows, GitHub Issues, Pull Requests, and Git Branches panels.

Press Ctrl+Alt+M (or run SnakeFlow: Tools from the palette) for the central quick-pick — servers, Quality Hub, GitHub, Cloud sync, and documentation. There is no separate $(tools) status-bar button; the shortcut is the main entry point.

Control (left → right)	Action
SnakeFlow project icon	Opens the Cloud dashboard (`devManager.cloud.dashboardUrl`)
Servers	Running/stopped counts — click for per-server Start / Stop / Restart (Dev Servers →)
Docker (when Compose detected)	Container status — click for the Containers menu
GitHub	Signed-in account or Sign in prompt
Git branch / sync	Ahead/behind vs default branch — click to pull or merge (Git Branches →)
$(add)	Create GitHub Issue (`Ctrl+Alt+G`)
Wake Lock (when enabled)	Toggle activity wake lock (Wake Lock →)
Team Tracker `$(watch)`	Today’s tracked minutes — click for activity log (Team Tracker →)
Realtime buckets (optional)	Compact diagnostic counts (Policy, Lint, Types, Security, Runtime, Debug, Schema) when `devManager.realtime.enabled` and `devManager.realtime.statusBar.enabled` are on — click opens the Problems panel
AI usage (optional)	Claude Code and Cursor subscription limit bars when `devManager.aiUsage.enabled` is on — see AI Usage settings
Workflow run (during a run)	Active workflow label and elapsed time

Where Settings Live

All SnakeFlow settings are standard VS Code settings under the devManager.* namespace.

Common ways to edit them:

Ctrl+, → search @ext:vaulttec-dev.snakeflow-dev-manager → use the graphical Settings UI
Edit .vscode/settings.json in your project directly (workspace-level settings are project-specific)
Command Palette → SnakeFlow: Open Settings (.vscode/settings.json) — creates the file if missing and opens it in the editor

Documentation site: Command Palette → SnakeFlow: Open Documentation (opens this site in your browser).

Keybindings

Default shortcuts use Ctrl+Alt+<letter>. Change any binding in Keyboard Shortcuts (search for SnakeFlow). Command titles for each action are listed in the command palette reference.

Shortcut	Action
`Ctrl+Alt+M`	Open main menu
`Ctrl+Alt+S`	Start all servers (`startWithAll` only)
`Ctrl+Alt+Q`	Stop all servers (every entry)
`Ctrl+Alt+R`	Restart all (stop all → bulk start)
Status bar → servers	Per-server Start / Stop / Restart menu
`Ctrl+Alt+F`	Run all Quality Hub checks
`Ctrl+Alt+I`	Run Quality Checks (changed files only)
`Ctrl+Alt+G`	Create GitHub Issue
`Ctrl+Alt+N`	Run Script (QuickPick of project tasks)
`Ctrl+Alt+P`	Filter Quality Providers (palette: Clear Quality Filter to reset)
`F4`	Toggle Voice Dictation (not when the integrated terminal has focus)
`Ctrl+Alt+Shift+H`	Cancel Voice Dictation (not when the integrated terminal has focus)

See also Run Scripts → for what task sources are detected (Makefile, package.json, monorepo server paths).