cbilling 0.3.0

Multi-cloud billing SDK for Rust — query billing data from AWS, GCP, Aliyun, Tencent Cloud, Volcengine, UCloud, Cloudflare
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

---
name: cbilling
description: Query and analyze multi-cloud billing data from AWS, GCP, Alibaba Cloud, Tencent Cloud, Volcengine, UCloud, and Cloudflare. Use this skill when the user asks about cloud costs, billing, spending, or wants to compare costs across cloud providers.
---

# cbilling — Multi-cloud Billing CLI

You have access to the `cbilling` CLI tool that queries real billing data from 7 cloud providers.

## Commands

### List configured providers

```bash
cbilling providers --format json
```

### Query a specific provider

```bash
# Current month
cbilling query <PROVIDER> --format json

# Specific month
cbilling query <PROVIDER> --month 2026-03 --format json
```

Providers: `aliyun`, `aws`, `tencentcloud`, `volcengine`, `ucloud`, `gcp`, `cloudflare`

### Summary across all providers

```bash
cbilling summary --format json
cbilling summary --month 2026-03 --format json
```

### Export to CSV

```bash
cbilling query aliyun --csv /tmp/billing.csv
```

## IMPORTANT: Always use `--format json`

Always add `--format json` to get structured output you can parse. Without it, the output is a human-readable table that is harder to analyze.

## JSON Response Schema

### `cbilling query <provider> --format json`

```json
{
  "billing_cycle": "2026-03",
  "provider": "aws",
  "total_cost": 4332.39,
  "currency": "USD",
  "products": [
    {
      "product_name": "Amazon Elastic Compute Cloud",
      "product_code": "AmazonEC2",
      "cost": 1792.78,
      "count": 12,
      "regions": ["us-east-1", "us-west-2"],
      "region_details": [
        {"region": "us-east-1", "cost": 1200.50, "count": 8},
        {"region": "us-west-2", "cost": 592.28, "count": 4}
      ]
    }
  ]
}
```

### `cbilling summary --format json`

```json
[
  {"provider": "aliyun", "billing_cycle": "2026-03", "total_cost": 98765.43, "currency": "CNY", "product_count": 65},
  {"provider": "aws", "billing_cycle": "2026-03", "total_cost": 4332.39, "currency": "USD", "product_count": 25}
]
```

## Example Workflows

### "What's my total cloud spend this month?"

```bash
cbilling summary --format json
```

Then sum costs by currency and present a breakdown.

### "Which AWS services cost the most?"

```bash
cbilling query aws --format json
```

Sort products by cost descending, show top 5.

### "Compare last month vs this month for Aliyun"

```bash
cbilling query aliyun --month 2026-03 --format json
cbilling query aliyun --month 2026-02 --format json
```

Compare `total_cost` and per-product costs between the two months.

### "Show me cost breakdown by region for GCP"

```bash
cbilling query gcp --format json
```

Extract `region_details` from each product and aggregate by region.

## Guidelines

- Always use `--format json` for structured output
- When comparing months, run the query twice with different `--month` values
- Currency may differ between providers (CNY for Chinese clouds, USD for AWS/GCP/Cloudflare)
- If a provider errors, suggest the user check their credentials configuration
- For the TUI dashboard, tell the user to run `cbilling` with no arguments