cloudview-cli

Cloud infrastructure visibility CLI — inspect instances, databases, storage, secrets, costs, and security across AWS, GCP, and Azure from your terminal.

7 free commands. 6 pro commands. All output supports --json.

Install

npm install -g cloudview-cli

Quick Start

# Set your cloud credentials
export AWS_ACCESS_KEY_ID=...
export AWS_SECRET_ACCESS_KEY=...
export AWS_REGION=us-east-1

# List running EC2 instances
cloudview instances --provider aws --state running

# Cost breakdown for current month
cloudview cost --provider aws

# Health dashboard
cloudview health --provider aws

How it works

flowchart LR
    CLI["cloudview CLI\n(Commander)"]
    subgraph Adapters
        AWS["AWS SDK v3"]
        GCP["GCP REST API"]
        AZ["Azure REST API"]
    end
    subgraph Free
        I[instances]
        D[databases]
        S[storage]
        SE[secrets]
        T[tags]
        H[health]
        C[cost]
    end
    subgraph Pro
        F[forecast]
        AN[anomalies]
        ID[idle]
        SC[security]
        CC[cross-cloud]
        CO[compliance]
    end
    CLI --> Free
    CLI --> Pro
    Free --> Adapters
    Pro --> Adapters
    Pro --> Gate["PRO_LICENSE gate"]

Commands

Free

| Command | Description | |---------|-------------| | cloudview instances --provider aws\|gcp\|azure | List compute instances | | cloudview databases --provider aws\|gcp\|azure | List managed databases | | cloudview storage --provider aws\|gcp\|azure | List storage buckets/containers | | cloudview secrets --provider aws\|gcp\|azure | List secret names (values never returned) | | cloudview tags --provider aws\|gcp\|azure --key <key> | Find resources by tag | | cloudview health --provider aws\|gcp\|azure | Infrastructure health dashboard | | cloudview cost --provider aws\|gcp\|azure | Cost breakdown for current month |

Pro (PRO_LICENSE=CPK-...)

| Command | Description | |---------|-------------| | cloudview forecast --provider aws\|gcp\|azure --months 3\|6\|12 | Cost forecast — conservative/realistic/optimistic | | cloudview anomalies --provider aws\|gcp\|azure | Cost anomaly detection vs 30-day baseline | | cloudview idle --provider aws\|gcp\|azure | Detect idle/underutilized resources | | cloudview security --provider aws\|gcp\|azure | Informational security findings | | cloudview cross-cloud --providers aws,gcp,azure | Unified multi-cloud inventory | | cloudview compliance --provider aws\|gcp\|azure | SOC2/ISO27001 reference mapping |

All commands support --json for machine-readable output.

Providers

| Provider | Auth Env Vars | |----------|--------------| | AWS | AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION | | GCP | GOOGLE_CLOUD_PROJECT, GOOGLE_ACCESS_TOKEN | | Azure | AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_SUBSCRIPTION_ID |

Security

• Secret values are NEVER returned. The secrets command lists names only. This is enforced at the adapter level — no secret value is ever fetched or included in any response.
• Pro commands are gated with PRO_LICENSE — reads dynamically from env at call time.
• Informational only: security and compliance commands are not audits or legal advice.

Examples

# AWS — list stopped instances
cloudview instances --provider aws --state stopped

# GCP — list postgres databases
cloudview databases --provider gcp --engine postgres

# Azure — list storage accounts in eastus
cloudview storage --provider azure --region eastus

# List secret names with prod/ prefix (values NEVER shown)
cloudview secrets --provider aws --prefix prod/

# Find all resources tagged Environment=production
cloudview tags --provider aws --key Environment --value production

# Cost for a specific month
cloudview cost --provider aws --month 2026-03

# JSON output for scripting
cloudview instances --provider aws --json | jq '.[].id'

# Pro: 12-month cost forecast
PRO_LICENSE=CPK-... cloudview forecast --provider aws --months 12

# Pro: detect idle resources
PRO_LICENSE=CPK-... cloudview idle --provider aws

# Pro: cross-cloud inventory
PRO_LICENSE=CPK-... cloudview cross-cloud --providers aws,gcp,azure

Exit Codes

| Code | Meaning | |------|---------| | 0 | Success | | 1 | Error (auth failure, missing args, API error) | | 2 | Warning/critical (health command only — degraded state) |

Pro License

Get a Pro license at craftpipe.dev/products/cloudview-cli.

export PRO_LICENSE=CPK-your-license-key
cloudview forecast --provider aws --months 6

Disclaimers

• Security command: INFORMATIONAL ONLY. Not a security audit.
• Compliance command: NOT LEGAL ADVICE. Reference mapping only — does not constitute certification.
• Cost data: Estimates only. AWS Cost Explorer API charges $0.01/request.

License

MIT — Craftpipe