Skip to content

VS Code Extension

The Flox extension for VS Code brings full environment management into your editor.

Features

  • Package management — install, uninstall, and upgrade packages from the sidebar
  • Environment activation — activate environments in the background without restarting VS Code
  • Terminal integration — environment variables propagate into VS Code's integrated terminal
  • Remote development — works with Remote SSH, Dev Containers, and WSL
  • Auto-sync — file watchers on manifest.toml and manifest.lock trigger automatic reactivation
  • Status bar — shows the active environment at a glance
  • TOML support — syntax highlighting for manifest.toml

Install from the Marketplace

Requirements

  1. Open the Extensions view (Cmd+Shift+X on macOS, Ctrl+Shift+X on Linux)
  2. Search for Flox
  3. Click Install

Works with Cursor

The Flox extension is compatible with Cursor. Install it the same way: open the Extensions view, search for "Flox", and install.

Build and install from source

If you prefer to install manually, you can build a .vsix file from the source repository:

  1. Clone the repository and check out a release tag:

    git clone https://github.com/flox/flox-vscode.git
cd flox-vscode
git checkout v1.0.1

  2. Activate the Flox environment and build the package:

    flox activate
npm run package

    This creates a .vsix file in the project directory.

  3. Install the .vsix file using the Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Linux):

    • Run Extensions: Install from VSIX...
    • Select the generated .vsix file

    Or install from the command line:

    code --install-extension flox-vscode-*.vsix

Source code

The extension is open source: github.com/flox/flox-vscode