• Installation
  • npx
  • npm
  • Shell script (macOS / Linux)
  • PowerShell (Windows)
• Quick Start
• Examples
  • Draw.io
  • Pulumi
• Supported Cloud Resources
• CLI Commands
• Configuration
• Integration Tests
• Contributing
• Reporting Issues
• License

npx @cloudcent/cli

npm install -g @cloudcent/cli

curl -fsSL https://raw.githubusercontent.com/OverloadBlitz/cloudcent-cli/main/install.sh | bash

irm https://raw.githubusercontent.com/OverloadBlitz/cloudcent-cli/main/install.ps1 | iex

cloudcent --help
cloudcent init

Run cloudcent init to authenticate through your browser.

This will generate a free API key and store it at:

~/.cloudcent/config.yaml

This API key is used to access the my pricing API.

No cloud or Pulumi account is required.

Note: For Pulumi projects, only Python is currently supported.

cloudcent diagram init aws-saas-example.drawio 

cloudcent diagram estimate aws-saas-example.drawio

TBD

cloudcent pulumi estimate

cloudcent                 # Show help
cloudcent init            # Authenticate via browser
cloudcent diagram init <file>      # Scaffold a YAML spec next to the diagram
cloudcent diagram estimate <file>  # Estimate costs from the diagram's spec
cloudcent pulumi estimate  # Estimate costs from pulumi codes
cloudcent history         # Show past queries
cloudcent cache stats     # Show cache statistics
cloudcent cache clear     # Clear cache and history
cloudcent metadata refresh  # Download latest pricing metadata
cloudcent config          # Show current configuration

Config is stored at ~/.cloudcent/config.yaml

Data files:

• ~/.cloudcent/metadata.json.gz — compressed pricing metadata
• ~/.cloudcent/cloudcent.db — SQLite database (history, cache)

Currently, I am using the following repositories as integration test cases:

• jgraph/drawio-diagrams
• pulumi/examples

These test cases are located under:

/integration_tests/testdata

Under the /integration_tests/snapshots directory, I store the expected total pricing results, which were manually adjusted based on the official cloud cost estimators.

The run-tests.sh script is for comparing the CLI output against the saved snapshots.

I am still working on adjusting and fixing test cases

1. Please create an issue first if you want to propose a change or fix.
2. I usually don’t create PRs in this repo. I use a separate private repo for creating, reviewing, and merging PRs, but feel free to open PRs here.
3. Feel free to use AI but need to pass integration tests before raising prs
4. Rebase against main branch and squash the commits before merging

Open an issue

The 0.0.2-beta-legacy branch includes a deprecated TUI for querying cloud costs across providers. It is no longer supported due to changes in the pricing data model, but remains noted here as an honorable mention. This CLI also has a TUI mode, I just disabled it for now and am still working on it

MIT