Skip to content
SnakeFlow SnakeFlow

FAQ & Troubleshooting

General

The extension doesn’t detect my project automatically

Press Ctrl+M M → Select Project → Browse to your project folder. Or set manually in .vscode/settings.json:

"devManager.project.name": "my-project",
"devManager.project.dir": "C:/Users/you/projects/my-project"

How do I configure servers for a project?

Open .vscode/settings.json and add:

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

Or use Ctrl+M M → Manage Servers for a UI wizard.

Settings aren’t being saved

Make sure you’re editing workspace settings (.vscode/settings.json), not user settings. In Ctrl+,, look for the “Workspace” tab.

Servers

Server shows as “stopped” but it’s running in a terminal

This can happen if you started the server outside of SnakeFlow. The status check requires both: (1) TCP port open and (2) a SnakeFlow-managed terminal. Start the server via Ctrl+M S to get full status tracking.

My server command runs from the wrong directory

Set the path field relative to the project root:

{ "id": "api", "command": "python manage.py runserver", "path": "backend", "port": 8000 }

If your root package.json is a proxy script ("dev": "npm run dev --prefix application"), use "path": "" — not "path": "application".

Docker

Docker Compose commands fail

Verify the compose CLI is available:

Terminal window
docker compose version

If you’re using the legacy docker-compose (with a hyphen):

"devManager.docker.composeCommand": "docker-compose"

Docker Desktop is installed but compose fails

Make sure Docker Desktop is running (the whale icon in the system tray). Docker CLI commands fail if the daemon isn’t running.

GitHub

GitHub Issues panel is empty

Make sure gh CLI is installed and authenticated:

Terminal window
gh auth status
# if not logged in:
gh auth login

PR panel shows no PRs

The PR panel shows only open PRs. If there are none, it will appear empty. Verify you have open PRs on GitHub.

Quality Hub

A check shows skip instead of running

The CLI tool for that check is not installed or not on PATH. Install it following the CLI Tools Installation guide.

Semgrep is slow or times out

Increase the timeout:

"devManager.quality.timeout": 60

Or add large generated directories to skip:

"devManager.quality.skipDirs": ["generated", "proto-gen"]

Cloud provider shows “No data available”

The cloud service needs at least one git push to collect data. If you haven’t pushed your code or your CI hasn’t run yet, there’s no data to display.

ESLint Security fails even though ESLint is installed

The ESLint Security check looks for eslint-plugin-security in node_modules. Install it:

Terminal window
npm i -D eslint-plugin-security

Bearer shows skip on Windows

Bearer has no native Windows binary. Options:

  1. Install it inside WSL2 and set: "devManager.quality.builtin.bearer.path": "wsl bearer"
  2. Skip it — other security checks (Semgrep, Trivy, ESLint Security) cover similar ground

Hadolint/ShellCheck/Trivy shows skip

The tool is not installed or not in PATH. Install it per the CLI Tools Installation guide. On Windows, make sure to restart VS Code/Cursor after installing via winget.

Windows-specific

Commands fail with encoding errors (Cyrillic characters in output)

Some tools fail on Windows with Cyrillic locale (CP1251). For Semgrep:

Terminal window
# Add to system environment variables:
PYTHONUTF8=1

PowerShell execution policy error

Terminal window
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Still stuck?

Feel free to reach out:

Please include:

  1. Your OS and VS Code / Cursor version
  2. The error message (from the Output panel → SnakeFlow)
  3. Your relevant .vscode/settings.json (remove tokens before sharing)