> ## Documentation Index
> Fetch the complete documentation index at: https://crust-f9187e76.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Commands

Crust provides several commands to help you analyze and understand your Terraform infrastructure. Here's a complete list of available commands:

## Main Commands

### `crust init`

Initializes Crust by creating a configuration file at `~/.crust.json`.

```bash theme={null}
crust init
```

This command will ask for:

* OpenAI API key
* Terraform plan command
* Preferred language

### `crust security`

Analyzes your Terraform infrastructure for potential security issues using OpenAI.

```bash theme={null}
crust security [--openai-api-key <key>] [--language <language>] [--terraform-plan-command <command>]
```

This command will:

* Run your Terraform plan
* Use OpenAI to analyze security issues
* Present findings with colorized output

### `crust cost`

Analyzes the cost of your AWS infrastructure changes using the AWS Pricing API.

```bash theme={null}
crust cost [--openai-api-key <key>] [--terraform-plan-command <command>]
```

This command will:

* Run your Terraform plan
* Calculate costs using AWS Pricing API
* Show cost comparisons
* Present results in a formatted table

### `crust explain`

Provides a clear explanation of your Terraform plan using OpenAI.

```bash theme={null}
crust explain [--openai-api-key <key>] [--language <language>] [--terraform-plan-command <command>]
```

This command will:

* Run your Terraform plan
* Generate a clear explanation in your configured language
* Include tips and recommendations

### `crust all`

Runs all analyses (security, cost, and explanation) at once.

```bash theme={null}
crust all [--openai-api-key <key>] [--language <language>] [--terraform-plan-command <command>]
```

This command will:

* Run the Terraform plan once
* Execute all three analyses on the output
* Present all results together

## Global Options

All commands support the following global options:

* `--help`: Show help for the command
* `--version`: Show version information
* `--openai-api-key <key>`: OpenAI API key to use for analysis
* `--language <language>`: Language to use for the analysis (e.g., "en", "pt-br")
* `--terraform-plan-command <command>`: Command to execute terraform plan

## Examples

### Basic Usage

```bash theme={null}
# Initialize Crust
crust init

# Run security analysis
crust security

# Run cost analysis
crust cost

# Get plan explanation
crust explain

# Run all analyses
crust all
```

## Configuration

Crust is configured through a global configuration file at `~/.crust.json`:

```json theme={null}
{
  "openaiKey": "your-openai-api-key",
  "terraformPlanCommand": "terraform plan",
  "language": "en"
}
```

See the [Configuration Guide](/docs/configuration.md) for more details.