ralph-config

Files (2)

• SKILL.md
• ralph-status.sh · scripts/

SKILL.md (first lines)

# Ralph User Configuration

Use this skill when setting up or modifying Ralph's user-level configuration at `~/.config/ralph/config.toml`.

## Config File Location

```
~/.config/ralph/config.toml
```

Create the directory if it doesn't exist:
```bash
mkdir -p ~/.config/ralph
```

## Quick Setup

Minimal config (both model and model_build are required):

```toml
[default]
model = "ck-gateway/claude-opus-4-5"
model_build = "ck-gateway/claude-haiku-4-5-20251001"
```

## Full Configuration Reference

```toml
# Ralph Wiggum Configuration
# https://ghuntley.com/ralph/

[default]
# Model for reasoning stages (PLAN, VERIFY, etc.)
model = "ck-gateway/claude-opus-4-5"
# Fast/cheap model for BUILD stage
model_build = "ck-gateway/claude-haiku-4-5-20251001"

# Context window settings (tokens)
context_window = 200000
context_warn_pct = 70      # Warning threshold
context_compact_pct = 85   # Trigger compaction
context_kill_pct = 95      # Kill iteration

# Timeouts (milliseconds)
stage_timeout_ms = 300000      # 5 min per stage
iteration_timeout_ms = 300000  # 5 min per iteration

# Circuit breaker - stop after N consecutive failures
max_failures = 3

# Maximum decomposition depth for stuck tasks
max_decompose_depth = 3

# Git settings
commit_prefix = "ralph:"
recent_commits_display = 3

# UI settings
# art_style: braille (default), braille_full, blocks, minimal, none
art_style = "braille"
dashboard_buffer_lines = 2000

# Directories
ralph_dir = "ralph"
log_dir = "/tmp/ralph-logs"
```

## Configuration Options

### Model Settings

| Option | Default | Description |
|--------|---------|-------------|
| `model` | (required) | AI model for reasoning stages |
| `model_build` | (required) | Fast/cheap model for BUILD stage |

**IMPORTANT**: Both `model` and `model_build` are required parameters.

#### CK AI Gateway Models (ck-gateway/)

For Credit Karma internal use, prefix models with `ck-gateway/`:

| Model | Description |
|-------|-------------|
| `ck-gateway/claude-opus-4-5` | Opus 4.5 - most capable |
| `ck-gateway/claude-opus-4-20250514` | Opus 4 |
| `ck-gateway/claude-sonnet-4-20250514` | Sonnet 4 |
| `ck-gateway/claude-sonnet-4-5-20250929` | Sonnet 4.5 |
| `ck-gateway/claude-haiku-4-5-20251001` | Haiku 4.5 - fastest/cheapest |

See https://code.corp.creditkarma.com/ck-private/de_ai-gateway for full model list.

#### Anthropic Direct Models

| Model | Description |
|-------|-------------|
| `anthropic/claude-sonnet-4` | Fast, cost-effective |
| `anthropic/claude-opus-4` | Most capable |

#### OpenRouter Models

| Model | Description |
|-------|-------------|
| `openrouter/anthropic/claude-opus-4` | Opus via OpenRouter |
| `openrouter/anthropic/claude-sonnet-4` | Sonnet via OpenRouter |

Note: OpenRouter requires `OPENROUTER_API_KEY` environment variable.

### Context Limits

| Option | Default | Description |
|--------|---------|-------------|
| `context_window` | `200000` | Total context window in tokens |
| `context_warn_pct` | `70` | Warning threshold (%) |
| `context_compact_pct` | `85` | Trigger compaction (%) |
| `context_kill_pct` | `95` | Kill iteration (%) |

**Behavior:**
- At `warn_pct`: Warning logged, execution continues

From djmittens/neo-mittens, MIT.

More from djmittens/neo-mittens