ralph-config

Configure Ralph user-level settings via a TOML file at ~/.config/ralph/config.toml.

Updated Jul 28, 2023
One-click install
npx skills add https://github.com/djmittens/neo-mittens --skill ralph-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-config
Source: https://github.com/djmittens/neo-mittens/tree/main/.opencode/skills/ralph-config
Command: npx skills add https://github.com/djmittens/neo-mittens --skill ralph-config

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph configuration can be tedious and error-prone when managing model settings, profiles, timeouts, and context limits across projects.

Core Features & Use Cases

  • Centralized TOML-based configuration for Ralph with required options (model, model_build) and a suite of optional settings.
  • Profiles support for environment-specific configurations and quick switching between setups.
  • Clear guidance on validation, troubleshooting, and migration from legacy setups.

Quick Start

Edit ~/.config/ralph/config.toml to set your default model and profile, then save and restart Ralph.

Frequently Asked Questions about ralph-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Ralph settings using a TOML file?

Ralph configuration requires both model and model_build to be defined in your TOML file for a valid setup. You can also optionally specify contexts, timeouts, and UI preferences to customize your local development environment.

Can I use profiles in Ralph for environment-specific configurations?

Ralph configuration supports profiles for environment-specific setups, allowing quick switching between different configurations. You can define multiple profiles within your TOML file alongside environment variables for flexible local development management.

What's the best way to validate Ralph configuration after editing the TOML file?

Validate Ralph configuration by ensuring both model and model_build fields are defined in your TOML file, then restart Ralph. The configuration tool provides guidance on troubleshooting and validation to catch errors in your settings.

Why does my Ralph configuration fail when switching between setups?

Ralph configuration fails if required model or model_build fields are missing from the TOML file. Use the provided validation and troubleshooting guidance to check profiles, environment variables, and required settings before restarting.

How do I migrate Ralph from a legacy setup to TOML-based configuration?

Migrate Ralph from a legacy setup by creating a TOML file at ~/.config/ralph/config.toml with required model and model_build fields. The configuration tool provides migration guidance to help transition existing settings into the new centralized format.