Skip to content

Extensions

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

Flox Agentic is an MCP server and skill library that gives AI coding agents access to Flox environments.

Install the MCP server

flox install flox/flox-mcp-server

Claude Code

Add the MCP server to your project:

claude mcp add flox -- flox-mcp

Or add it user-wide:

claude mcp add --scope user flox -- flox-mcp

Cursor

Add the following to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "flox": {
      "command": "flox-mcp"
    }
  }
}

Other MCP clients

Any editor or agent that supports the Model Context Protocol can use Flox Agentic. Point your client at the flox-mcp command using stdio transport.

Learn more

Full documentation and source code: github.com/flox/flox-agentic