SnakeFlow

SnakeFlow is a VS Code / Cursor extension for managing development environments — any project, any language.

Control dev servers, run builds, manage databases, containers, GitHub issues and PRs — all from one sidebar and a single keybinding (Ctrl+M M).

Install

Search for SnakeFlow: Dev Environment Manager in the Extensions panel, or install via command:

ext install vaulttec-dev.snakeflow-dev-manager

Features

Servers

Start, stop, and restart any number of dev servers — Next.js, Vite, Django, Rails, Go, or any custom command. Configure once, run forever.

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

Pipeline

Run lint → format → typecheck → tests → build as a sequential pipeline with a pass/fail summary. Stops on first failure.

Scripts

Run any script from package.json directly from a quick-pick menu — no terminal needed.

Database

Auto-detects Prisma, Drizzle, TypeORM, and Knex from project dependencies. Fully customizable with variable substitution.

Containers

Docker Compose up/down/restart with configurable custom actions. Supports docker compose, docker-compose, and podman compose.

GitHub Actions (CI)

Run GitHub Actions workflows locally via act.

GitHub Issues

Create, edit, close, comment, filter by milestone/assignee/date, search, create branch from issue, send to Cursor Chat.

Pull Requests

View open PRs in the sidebar. Send PR context to Cursor Chat for AI review.

Git Branches

Manage branches from the sidebar — checkout, delete single or multiple branches. Protected branches require extra confirmation.

Security

Semgrep security scan with three profiles: auto, security-audit, and CI dry-run.

Status Bar

Project name — click to open the main menu
Server status — live per-port monitoring with combined port + terminal check
Docker — shows whether a Compose file is detected
GitHub — shows signed-in account or prompts to sign in
Git branch — current branch with ↑ahead / ↓behind indicators; click to pull

Requirements

Required:

VS Code ^1.85 or Cursor
Node.js >= 18

Optional (enable additional features):

gh CLI — GitHub Issues, PRs, and PR AI Feedback
act — run GitHub Actions locally
Docker Desktop or Podman — Container management
Semgrep — Security scanning
Google Gemini API key — AI-powered issue title generation

Quick Start

Install the extension
Open a project folder in VS Code / Cursor
Press Ctrl+M M — the extension auto-detects the project and package manager
Configure servers via Manage Servers or edit devManager.project.servers in Settings
Use the menu to start servers, run the pipeline, manage GitHub, and more

All settings are stored in VS Code's standard Settings UI (@ext:vaulttec-dev.snakeflow-dev-manager). No separate config files.

Keybindings

Shortcut	Action
`Ctrl+M M`	Open main menu
`Ctrl+M S`	Start servers
`Ctrl+M Q`	Stop servers
`Ctrl+M R`	Restart servers
`Ctrl+M F`	Run pipeline
`Ctrl+M N`	Run npm script
`Ctrl+M I`	Create GitHub Issue

Configuration

All settings live under the devManager.* namespace in VS Code Settings (@ext:vaulttec-dev.snakeflow-dev-manager):

Setting	Description
`devManager.project.servers`	Array of dev servers (id, label, command, path, port)
`devManager.project.packageManager`	`auto` \| `npm` \| `pnpm` \| `yarn` \| `bun`
`devManager.project.containerActions`	Custom container menu actions
`devManager.pipeline.steps`	Ordered list of pipeline commands
`devManager.pipeline.stopDevServer`	Stop servers before running pipeline
`devManager.git.defaultBranch`	Default branch name fallback (`main`)
`devManager.git.protectedBranches`	Branches requiring extra confirmation to delete
`devManager.database.actions`	Custom database action menu (auto-detected if empty)
`devManager.docker.composeCommand`	Compose CLI (`docker compose`, `podman compose`, etc.)
`devManager.prToChat.prompt`	Custom prompt prepended when sending a PR to Cursor Chat
`devManager.issueToChat.prompt`	Custom prompt prepended when sending an issue to Cursor Chat
`devManager.github.defaultMilestone`	Default milestone for new GitHub Issues
`devManager.gemini.apiKey`	Google Gemini API key for AI title generation
`devManager.gemini.model`	Gemini model name (default: `gemini-2.5-flash`)

Development

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch mode
npm run watch

# Lint
npm run lint

# Package .vsix
npx @vscode/vsce package

# Install locally (version from package.json)
cursor --install-extension snakeflow-dev-manager-$(node -p "require('./package.json').version").vsix --force

Press F5 in VS Code to launch the Extension Development Host.

License

MIT