Kustomize Navigator
A Visual Studio Code extension that enhances your Kubernetes GitOps workflow by providing intelligent navigation between Kustomize YAML files.
Features
- Smart Navigation: Ctrl+click to navigate between Kustomize files
- Back References: View which files reference the current file
- Flux Support: Works with both standard Kustomize and Flux CD
- Variable Highlighting: Highlights and validates Flux variable substitutions
- Intelligent Diagnostics: Identifies common configuration issues
- References Explorer: View all references in a dedicated panel

Quick Start
- Open a Kubernetes GitOps repository
- Use Ctrl+Click on any kustomization reference to navigate
- View back references in the "Kustomize Back References" panel
- Hover over Flux variables for details and suggestions
Extension Settings
Key settings (see VS Code settings for all options):
kustomizeNavigator.highlightFluxVariables : Enable/disable Flux variable highlighting
kustomizeNavigator.diagnostics.enabled : Toggle all diagnostic checks
kustomizeNavigator.standardFluxVariables : List of standard Flux variables for autocompletion
Diagnostic Checks
The extension provides comprehensive validation for your Kubernetes and Flux configurations:
Kubernetes Checks
- Resource naming conventions
- Namespace requirements
- Image tag usage
- YAML formatting
Security Checks
- Privileged containers
- Host network usage
- Security context settings
Flux-specific Checks
- API version deprecation
- Recursive dependencies
- Variable substitution
- GitOps components
- Performance optimization
Each check can be individually enabled/disabled in settings.
Recent Changes
0.8.1
- Improved handling of references for all YAML files
- Enhanced display of Flux and K8s references
- Better error handling and user feedback
- More descriptive messages in references view
0.8.0
- Create kustomization files by clicking links
- Improved directory target handling
- Better diagnostics for missing files
0.7.2
- Enhanced References View with document counts
- Fixed back reference tracking
- Improved path resolution
0.7.1
- Simplified References View
- Updated UI and documentation
Known Issues
- Remote Git references not supported
- May activate on YAML files without kustomization files
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This extension is licensed under the MIT License.
| |