Extension Settings

Overview

HAI Build Code Generator can be configured through various settings to customize your development experience. Settings can be managed through the VS Code settings interface or by modifying configuration files directly.

Extension Configuration

Workspace Settings

The extension supports workspace-specific configuration through the .hai.config file placed at the root of your workspace.

The .hai.config file is not git-excluded by default. Ensure sensitive keys are not committed to your repository.

Configuration File Format

The .hai.config file uses a simple key-value format:

# Project name
name=my-project

# Langfuse Configuration
langfuse.apiUrl=https://cloud.langfuse.com
langfuse.apiKey=your-api-key
langfuse.publicKey=your-public-key

# PostHog Configuration
posthog.url=https://app.posthog.com
posthog.apiKey=your-api-key

# COR-Matrix Configuration
cormatrix.baseURL=https://cormatrix.example.com
cormatrix.token=your-token
cormatrix.workspaceId=your-workspace-id

Environment Variables

For local development, you can use environment variables to configure the extension. See the .env.example file for available options.

Development Environment Variables

# Development Flags
IS_DEV=true
CLINE_ENVIRONMENT=local

# Langfuse Telemetry
LANGFUSE_SECRET_KEY=your-langfuse-secret-key
LANGFUSE_PUBLIC_KEY=your-langfuse-public-key
LANGFUSE_BASE_URL=https://cloud.langfuse.com

# PostHog Telemetry
TELEMETRY_SERVICE_API_KEY=your-posthog-telemetry-api-key
ERROR_SERVICE_API_KEY=your-posthog-error-tracking-api-key

# OpenTelemetry (Optional)
OTEL_TELEMETRY_ENABLED=1
OTEL_LOGS_EXPORTER=console
OTEL_METRICS_EXPORTER=otlp
OTEL_EXPORTER_OTLP_PROTOCOL=grpc
OTEL_EXPORTER_OTLP_ENDPOINT=localhost:4317

Activation Events

The extension activates automatically in the following scenarios:

On Language Detection

Activates when any programming language file is opened

On Startup

Activates when VS Code finishes starting up

Workspace Contains

Activates when workspace contains evals.env file

Commands and Keybindings

HAI Build provides several commands accessible via the Command Palette and keyboard shortcuts.

Default Keybindings

keybinding

Jump to HAI chat input or add selected code to chat

Available Commands

Command	Description	Shortcut
New Task	Start a new HAI task	-
MCP Servers	Manage Model Context Protocol servers	-
History	View task history	-
Settings	Open HAI settings	-
Add to HAI	Add selected code to chat	Cmd/Ctrl + ‘
Generate Commit Message	Generate AI-powered commit messages	-
Explain with HAI	Explain selected code	-
Improve with HAI	Get improvement suggestions	-

Storage Configuration

HAI Build supports object storage backends for syncing data across devices.

S3 Storage

CLINE_STORAGE_ADAPTER="s3"
CLINE_STORAGE_BUCKET="cline"
CLINE_STORAGE_ACCESS_KEY_ID="your-access-key"
CLINE_STORAGE_SECRET_ACCESS_KEY="your-secret-key"
CLINE_STORAGE_REGION="us-west-1"  # Optional, defaults to us-east-1
CLINE_STORAGE_ENDPOINT="http://localhost:8333"  # Optional

Cloudflare R2 Storage

CLINE_STORAGE_ADAPTER="r2"
CLINE_STORAGE_BUCKET="cline"
CLINE_STORAGE_ACCESS_KEY_ID="your-access-key"
CLINE_STORAGE_SECRET_ACCESS_KEY="your-secret-key"
CLINE_STORAGE_ACCOUNT_ID="your-account-id"
CLINE_STORAGE_ENDPOINT="http://localhost:8333"  # Optional

Storage Sync Options

number

default:"30000"

Interval for sync worker in milliseconds

number

default:"5"

Maximum retries for failed sync operations

number

default:"10"

Number of files to sync in each batch

boolean

default:"false"

Enable backfill of existing data on startup

Advanced Settings

Multi-Root Workspace Debugging

MULTI_ROOT_TRACE=true

gRPC Recorder

Enable gRPC request/response recording for testing:

GRPC_RECORDER_ENABLED=true
GRPC_RECORDER_FILE_NAME=test-recording

Test Mode

E2E_TEST=true
IS_TEST=true

Next Steps

LLM Providers

Configure AI model providers

Telemetry

Set up telemetry and monitoring

Experts

Create custom domain experts

Get Started

Core Features

Configuration

Usage Guides

Advanced

Overview

Extension Configuration

Workspace Settings

Configuration File Format

Environment Variables

Activation Events

On Language Detection

On Startup

Workspace Contains

Commands and Keybindings

Default Keybindings

Available Commands

Storage Configuration

S3 Storage

Cloudflare R2 Storage

Storage Sync Options

Advanced Settings

Multi-Root Workspace Debugging

gRPC Recorder

Test Mode

Next Steps

LLM Providers

Telemetry

Experts

​Overview

​Extension Configuration

​Workspace Settings

​Configuration File Format

​Environment Variables

​Activation Events

On Language Detection

On Startup

Workspace Contains

​Commands and Keybindings

​Default Keybindings

​Available Commands

​Storage Configuration

​S3 Storage

​Cloudflare R2 Storage

​Storage Sync Options

​Advanced Settings

​Multi-Root Workspace Debugging

​gRPC Recorder

​Test Mode

​Next Steps

LLM Providers

Telemetry

Experts

Overview

Extension Configuration

Workspace Settings

Configuration File Format

Environment Variables

Activation Events

Commands and Keybindings

Default Keybindings

Available Commands

Storage Configuration

S3 Storage

Cloudflare R2 Storage

Storage Sync Options

Advanced Settings

Multi-Root Workspace Debugging

gRPC Recorder

Test Mode

Next Steps