Installation

Prerequisites

Before installing Crust, make sure you have:

• Node.js 18 or higher
• npm, yarn, or pnpm
• Terraform or Terragrunt installed
• OpenAI API key
• AWS credentials (for cost analysis)

Installation Methods

Global Installation (Recommended)

npm install -g @typper-io/crust

Using npx

If you prefer not to install Crust globally, you can use npx:

npx @typper-io/crust

From Source

If you want to contribute to Crust or need the latest features:

# Clone the repository
git clone https://github.com/typper-io/crust.git

# Install dependencies
cd crust
pnpm install

# Build the project
pnpm build

# Link the package globally
pnpm link --global

Initial Configuration

After installation, you need to initialize Crust with your OpenAI API key:

crust init

This will:

1. Create a configuration file at ~/.crust.json
2. Ask for your OpenAI API key
3. Ask for your preferred Terraform plan command
4. Ask for your preferred language

Example configuration file:

{
  "openaiKey": "your-openai-api-key",
  "terraformPlanCommand": "terraform plan",
  "language": "en"
}

Verification

After installation and configuration, verify that Crust is working:

crust --version