CloudVerse FinOps for VS Code

Developer-Native FinOps Platform - Real-time cloud cost analysis and ML-powered optimization recommendations directly in your editor.

Embed cost awareness into your development workflow with instant cost estimates for Terraform, CloudFormation, and Helm charts. CloudVerse analyzes your Infrastructure as Code (IaC) and provides accurate monthly cost projections for AWS, Azure, and GCP - before you deploy.

✨ Key Features

💰 Real-Time Cost Analysis

• Inline Cost Decorations: See estimated monthly costs directly next to your Terraform resources
• Live Updates: Automatic cost recalculation as you edit IaC files
• Multi-Cloud Support: AWS, Azure, and GCP pricing with 59+ supported services
• Accurate Estimates: SKU-level pricing calculations using official cloud provider APIs

💡 ML-Powered Optimization

• Smart Recommendations: AI-driven cost optimization suggestions
• Savings Calculations: Potential monthly and annual savings for each recommendation
• Risk Assessment: Low/Medium/High risk evaluation for every optimization
• Effort Estimation: Implementation time and complexity ratings
• Code Snippets: Ready-to-use Terraform code for quick implementation

📊 Rich Visualizations

• Hover Tooltips: Detailed SKU breakdowns with pricing per unit
• Status Bar: Quick view of total monthly costs at a glance
• Cost Breakdown Panel: Interactive webview with comprehensive resource details
• Recommendation Dashboard: Sortable list of all optimization opportunities

🔧 Developer Experience

• Auto-Analysis: Automatic cost updates on file save
• Output Channel: Detailed logging for debugging
• Configurable: Customize API endpoint, provider, region, and behavior
• Fast: Optimized with debounced analysis and caching

📦 Installation

From VS Code Marketplace

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X or Cmd+Shift+X on Mac)
3. Search for "CloudVerse FinOps"
4. Click Install

From VSIX File

1. Download the latest .vsix from Releases
2. In VS Code: Extensions → ... menu → Install from VSIX
3. Select the downloaded file

🚀 Quick Start

1. Configure API Connection

Open VS Code Settings (Ctrl+,) and search for "CloudVerse":

{
  "cloudverse.apiUrl": "http://localhost:5000",
  "cloudverse.apiKey": "your-api-key-here",
  "cloudverse.defaultProvider": "aws",
  "cloudverse.defaultRegion": "us-east-1"
}

2. Open a Terraform File

Open any .tf file in your workspace. The extension activates automatically.

3. Analyze Costs

Automatic: Save the file (Ctrl+S) - costs appear inline automatically Manual: Command Palette (Ctrl+Shift+P) → "CloudVerse: Analyze Infrastructure Costs"

4. View Details

• Hover over any resource for detailed SKU breakdown
• Click the status bar cost to see full breakdown
• Review optimization recommendations in the cost panel

📖 Usage Guide

Inline Cost Decorations

As you edit Terraform files, CloudVerse shows estimated monthly costs inline:

resource "aws_instance" "web" {              # 💰 $73.20/month 💡 2
  instance_type = "t3.medium"
  ami           = "ami-0abc123"
}

The 💡 indicator shows the number of optimization recommendations available.

Hover for Details

Hover over any resource to see:

• Resource details: ID, type, region
• Monthly cost: Precise cost estimate
• SKU breakdown: Line-item pricing details
• Recommendations: Top optimization opportunities with:
  • Savings potential (monthly/annual)
  • Implementation effort (time estimate)
  • Risk level assessment
  • Code snippets for quick implementation

Cost Breakdown Panel

Click the status bar cost or use Command Palette to open an interactive panel showing:

• Total monthly infrastructure cost
• Resource-by-resource breakdown
• Top 10 optimization recommendations
• Sortable tables with filtering

Commands

Access via Command Palette (Ctrl+Shift+P):

⚙️ Configuration

All settings are available in VS Code Settings (Ctrl+,) under "CloudVerse":

Connection Settings

Cloud Provider Settings

Behavior Settings

Example Configuration

For AWS in US East:

{
  "cloudverse.apiUrl": "https://api.cloudverse.ai",
  "cloudverse.apiKey": "cv_live_your_key_here",
  "cloudverse.defaultProvider": "aws",
  "cloudverse.defaultRegion": "us-east-1"
}

For Azure in West Europe:

{
  "cloudverse.defaultProvider": "azure",
  "cloudverse.defaultRegion": "westeurope"
}

For GCP in US Central:

{
  "cloudverse.defaultProvider": "gcp",
  "cloudverse.defaultRegion": "us-central1"
}

🎯 Supported IaC Formats

• ✅ Terraform (.tf files)
• ✅ CloudFormation (.yaml, .json templates)
• ✅ AWS CDK (TypeScript, Python)
• ✅ Helm Charts (Kubernetes)

💼 Use Cases

Cost-Aware Development

Developers see costs as they write infrastructure code, enabling cost-conscious decisions from the start.

Pull Request Reviews

Reviewers can see cost impact of proposed changes before merging, preventing budget surprises.

Optimization Discovery

Identify cost-saving opportunities early with ML-powered recommendations and one-click implementation.

Multi-Cloud Cost Comparison

Compare costs across AWS, Azure, and GCP for the same infrastructure to find the best value.

🔒 Security & Privacy

• No Code Uploads: IaC files are analyzed by your self-hosted CloudVerse API
• API Key Security: Keys are stored securely in VS Code settings
• Private Deployment: Run the entire platform in your private cloud
• No Telemetry: Extension does not collect usage data

📋 Requirements

• VS Code: Version 1.85.0 or higher
• CloudVerse API: Running instance (locally or remote)
  • Download from GitHub
  • Or use hosted version at https://api.cloudverse.ai

🐛 Troubleshooting

Extension Not Working

1. Check CloudVerse API is running: curl http://localhost:5000/health
2. Verify API URL in settings matches your API endpoint
3. Check Output channel: View → Output → Select "CloudVerse"

No Cost Decorations

1. Ensure cloudverse.enableDecorations is true
2. Save the file to trigger analysis
3. Check file extension is .tf, .yaml, or .json

Authentication Errors

1. Verify API key is valid: Settings → CloudVerse → API Key
2. Test API connection manually: curl -H "Authorization: Bearer YOUR_KEY" http://localhost:5000/api/estimates

Slow Performance

1. Disable auto-analysis: Set cloudverse.autoAnalyze to false
2. Use manual analysis only (Command Palette)
3. Check API server performance and logs

🤝 Contributing

Contributions are welcome! Please see our Contributing Guide for details.

📝 Development

Setup

git clone https://github.com/cloudverse-ai/vscode-extension
cd vscode-extension
npm install

Build & Test

# Compile TypeScript
npm run compile

# Watch mode (auto-recompile on changes)
npm run watch

# Type check
npm run lint

# Package extension
npm run package

Debug

1. Open the project in VS Code
2. Press F5 to open Extension Development Host
3. Test the extension in the new window

📦 Publishing

# Package for distribution
npm run package

# Publish to marketplace (requires publisher account)
npm run publish

# Publish with version bump
npm run publish:patch   # 1.0.0 → 1.0.1
npm run publish:minor   # 1.0.0 → 1.1.0
npm run publish:major   # 1.0.0 → 2.0.0

📞 Support

• Email: support@cloudverse.ai

📜 License

MIT License - see LICENSE for details

🌟 Acknowledgments

Built with ❤️ by the CloudVerse.ai team. Special thanks to the open-source community for their invaluable contributions.

Embed cost awareness in your development workflow. Install CloudVerse FinOps today!