A Visual Studio Code extension that enhances the development experience for Infrahub - the open-source infrastructure automation platform. This extension provides intelligent tooling for working with Infrahub schemas, GraphQL queries, and configuration files.
The Infrahub VSCode Extension streamlines infrastructure-as-code development by providing real-time connectivity to Infrahub servers, schema validation, GraphQL query execution, and branch management capabilities directly within your IDE. Whether you're defining infrastructure models, writing automation queries, or managing schema versions across branches, this extension accelerates your workflow and reduces context switching.
- Schema Development: Create and validate Infrahub schemas with real-time feedback and auto-completion
- GraphQL Query Testing: Write and execute GraphQL queries against live Infrahub instances without leaving VSCode
- Branch-based Workflows: Manage infrastructure changes across different branches with Git-like version control
- Multi-Server Development: Connect to multiple Infrahub environments (dev, staging, production) simultaneously
- Infrastructure Modeling: Develop network device models, data center schemas, and service definitions with YAML validation
- Automation Development: Build and test automation workflows that integrate with Infrahub's graph database
- Connect to multiple Infrahub servers with secure API token authentication
- Real-time server status monitoring in the status bar
- Support for environment variable substitution in configuration
- Automatic connection health checks every 10 seconds
- Infrahub Servers View: Browse connected servers and their branches
- Infrahub YAML View: Navigate
.infrahub.ymlfile structure with a hierarchical tree - Quick actions available directly from tree view context menus
- Schema-aware YAML validation for
models/andschemas/directories - Go-to-definition support for schema references
- Document outline/symbols for easy navigation
- Syntax highlighting and error detection
- Quickly scaffold Infrahub transforms, scripts, generators, checks, and YAML objects using built-in VSCode snippets
- Reduce manual typing and avoid syntax errors with reusable templates
- Execute GraphQL queries directly from the tree view
- Interactive variable prompting for query parameters
- Branch-aware query execution
- Results displayed in formatted webview panels
- Create new branches from the UI
- Delete branches with confirmation
- View branch metadata (description, origin, schema changes)
- Switch between branches for testing
- Live server connection status
- Current server version display
- Visual indicators for connection health
- Open VSCode
- Navigate to Extensions (
Ctrl+Shift+X/Cmd+Shift+X) - Search for "Infrahub"
- Click Install on the Infrahub extension by OpsMill
# Download the latest release
curl -L https://github.com/opsmill/infrahub-vscode/releases/latest/download/infrahub-x.x.x.vsix -o infrahub.vsix
# Install using VSCode CLI
code --install-extension infrahub.vsix# Clone the repository
git clone https://github.com/opsmill/infrahub-vscode.git
cd infrahub-vscode
# Install dependencies
npm install
# Compile and package
npm run compile
npm run vscode:prepublish
vsce package
# Install the generated .vsix file
code --install-extension infrahub-*.vsix- Infrahub VSCode Extension Documentation: Infrahub Docs
- Visual Studio Code v1.99.0 or higher
- Active Infrahub server instance (v0.15.0 or higher recommended)
- Valid API token for authentication (optional but recommended)
Contributions are welcome! Please feel free to submit issues and pull requests to the GitHub repository.
For more details, see the CONTRIBUTING.md file.
This extension is part of the Infrahub project. See the LICENSE file for details.
- Issues: GitHub Issues
- Community: Infrahub Discord
Built with ❤️ by the OpsMill team and the Infrahub community.