# Chalk CLI Reference: Support
source: https://docs.chalk.ai/cli#support

Generate diagnostic bundles, submit feedback, and view usage information. These commands help when troubleshooting issues with the Chalk team.

## `chalk flare`
source: https://docs.chalk.ai/cli?command=flare

```bash
chalk flare
```

Use the `flare` command to send your code to a partner at Chalk for assistance.

**Example**

```
$ chalk flare
Code uploaded successfully
```

## `chalk flare list`
source: https://docs.chalk.ai/cli?command=flare_list

```bash
chalk flare list
```

Use the `flare list` command to list your flares.

**Example**

```
$ chalk flare list
```

## `chalk flare download`
source: https://docs.chalk.ai/cli?command=flare_download

```bash
chalk flare download [flags]
```

Use the `chalk flare download` command to download a flare by its ID and extract it to a directory. If no ID is provided, an interactive table will be shown for selection.

**Flags**

- `--id <flare-id>` (string)
  The ID of the flare to download. If not provided, shows an interactive table to select from.
- `-o, --output <directory>` (string, default `.`)
  Output directory to extract the flare to.

**Example**

```
$ chalk flare download
$ chalk flare download --id abc123
$ chalk flare download --id def456 --output ./flares/
$ chalk flare download --id xyz789 -o /tmp/flare-download/
```

## `chalk feedback`
source: https://docs.chalk.ai/cli?command=feedback

```bash
chalk feedback
```

Submit feedback to the Chalk team.

**Example**

```
$ chalk feedback
      _           _ _    
     | |         | | |   
  ___| |__   __ _| | | __   _____
 / __| '_ \ / _` | | |/ /  |     |
| (__| | | | (_| | |   <   |     |
 \___|_| |_|\__,_|_|_|\_\  |_____|
                         
                         
We love hearing your feedback and suggestions!
Feel free to add issues to our public roadmap: https://github.com/chalk-ai/roadmap/
```

## `chalk usage export`
source: https://docs.chalk.ai/cli?command=usage_export

```bash
chalk usage export
```

Use the 'export' command to retrieve and export Chalk usage data based on specified criteria.

The 'export' command allows you to fetch usage data from Chalk and save it as a CSV file for external analysis. You can group the data by 'cluster', 'instance', or 'nodepool' and specify the reporting period as either 'daily' or 'monthly'. Additionally, you can set custom date ranges to filter the exported data based on start and end dates.

**Flags**

- `--grouping <cluster|instance|nodepool>` (string, default `cluster`)
  Grouping for the usage chart, one of `cluster`, `instance`, or `nodepool`.
- `--period <daily|monthly>` (string, default `daily`)
  The period for the usage chart. Expects `'daily'` or `'monthly'`.
- `--start <start>` (string)
  Start time for the usage chart in ISO 8601 format. By default, 180 days ago.
- `--end <end>` (string)
  End time for the usage chart in ISO 8601 format. By default, now.
- `--out <export.csv>` (string)
  Optionally save the usage chart to a file. If not specified, this command will print the chart to the terminal.

**Example**

```
$ chalk usage export --period monthly
 Date                     Credits  Label
─────────────────────────────────────────────────────────────────
 2024-05-17 00:00:00 UTC  8925.98  sandbox-eks-cluster
 2024-06-17 00:00:00 UTC  8283.77  sandbox-eks-cluster
 2024-07-17 00:00:00 UTC  3769.53  sandbox-eks-cluster
```

## `chalk usage chart`
source: https://docs.chalk.ai/cli?command=usage_chart

```bash
chalk usage chart
```

Use the 'chart' command to read the usage behind the dashboard's Usage page.

The default 'billing' source is billed usage: CCUs or credits, split across your commitments and overage. A chart never mixes units: it reads your team's current billing model unless you pass --billing-model. The 'credits' source is raw node credits, and 'compute' is observed sandbox and scaling-group usage. Run 'chalk usage facets' to list each source's group-by and filter facets.

**Flags**

- `--source <billing|credits|compute>` (string, default `billing`)
  Usage to chart: `billing` (billed CCUs or credits, by commitment), `credits` (raw node credits), or `compute`.
- `--group-by <group-by>` (string[], default `[]`)
  Facet to group by, outermost first; repeat for up to three. See `chalk usage facets` for each source's facets.
- `--query <facet:value>` (string)
  Filter in faceted search syntax, e.g. `workload_type:online cluster:prod`.
- `--period <daily|monthly|hourly>` (string, default `daily`)
  Bucket size: `daily` or `monthly`, or `hourly` for the credits source.
- `--start <start>` (string)
  Start of the range, as a date (2026-10-01) or ISO 8601 time. By default, the last 12 calendar months for a monthly chart, otherwise 30 days ago.
- `--end <end>` (string)
  End of the range, as a date or ISO 8601 time. By default, now.
- `--billing-model <ccu|credits>` (string)
  Billing source only: chart `ccu` or `credits` usage. By default, the team's current billing model.
- `--out <usage.csv>` (string)
  Save the chart as CSV instead of printing it.

**Example**

```
$ chalk usage chart --period monthly --group-by cluster --group-by workload_type --query 'workload_type:online OR workload_type:offline'
 Date        cluster            workload_type  CCUs
──────────────────────────────────────────────────────
 2026-10-01  prod-eks-cluster   online         4210.55
 2026-10-01  prod-eks-cluster   offline        1180.02
```

## `chalk usage facets`
source: https://docs.chalk.ai/cli?command=usage_facets

```bash
chalk usage facets
```

List the facets usage can be grouped and filtered by

**Flags**

- `--source <billing|credits|compute>` (string, default `billing`)
  Usage source whose facets to list: `billing`, `credits`, or `compute`.

**Example**

```
$ chalk usage facets --source billing
 Facet          Name
─────────────────────────────
 bundle         Bundle
 cluster        Cluster name
 workload_type  Workload type
```

## `chalk usage instances`
source: https://docs.chalk.ai/cli?command=usage_instances

```bash
chalk usage instances
```

Get instance usage data

**Flags**

- `--format <pretty|csv>` (string, default `pretty`)
  Output format for the instances command. Either `'pretty'` or `'csv'`.

**Example**

```
$ chalk usage instances
```

## `chalk usage rates`
source: https://docs.chalk.ai/cli?command=usage_rates

```bash
chalk usage rates
```

Get the billing utilization rates for different machine types

**Example**

```
$ chalk usage rates
Cloud  Machine            vCPUs  Memory (gb)  Credits/hr
──────────────────────────────────────────────────────────
GCP    n2d-standard-4     4      16           0.85
GCP    n2d-standard-8     8      32           1.7
GCP    n2d-standard-16    16     64           3.4
GCP    n2d-standard-32    32     128          6.8
```

## `chalk usage bundles`
source: https://docs.chalk.ai/cli?command=usage_bundles

```bash
chalk usage bundles
```

Show credit bundles for your team

**Example**

```
$ chalk usage bundles
Bundle ID         Purchase Date  Credits  Price      Remaining  Expires On
─────────────────────────────────────────────────────────────────────────────
bundle_1000       2024-01-15     1000     $100.00    750        2024-07-15
bundle_5000       2024-02-20     5000     $450.00    2300       2024-08-20
```

## `chalk usage resource-group pods`
source: https://docs.chalk.ai/cli?command=usage_resource_group_pods

```bash
chalk usage resource-group pods
```

Enumerate the lifetimes of pods in a resource group during a time period, showing CPU/memory requests and limits, workload type, and node placement.

**Flags**

- `-s, --service-kind <engine>` (string, default `engine`)
  The service kind to filter by (e.g. 'engine').
- `-r, --resource-group <default>` (string)
  The resource group to filter by (e.g. 'default').
- `--start <start>` (string)
  Start time filter in ISO 8601 format. By default, 7 days ago.
- `--end <end>` (string)
  End time filter in ISO 8601 format. By default, now.

**Example**

```
$ chalk usage resource-group pods --resource-group default
Pod Name                        Start Time           End Time             Workload Type  Node             CPU Req  CPU Lim  Mem Req  Mem Lim
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
engine-abc123-xyz               2025-01-01 00:00:00  2025-01-02 12:00:00  engine         node-pool-abc    2        4        4Gi      8Gi
```
