feat: interactive provider wizard (/setup, claw setup, Ctrl+P)

[TheArchitectit]

Summary

Adds an interactive provider wizard so users can configure their AI provider, API key, base URL, and model without manually editing config files or setting environment variables. Settings persist across sessions in ~/.claw/settings.json.

Three ways to access the wizard:

• claw setup — CLI subcommand
• /setup — slash command inside the REPL
• Ctrl+P — hotkey inside the REPL (inserts [Provider Swap] prompt, press Enter to confirm)

Problem this solves

No way to configure providers without environment variables

Before: the only way to set your provider, API key, base URL, or model was via environment variables (ANTHROPIC_API_KEY, OPENAI_API_KEY, OPENAI_BASE_URL, etc.) or manually editing a settings file. There was no guided setup — users had to read docs, figure out which env vars to set, and hope they got the names right. Switching providers mid-session required exiting, setting new env vars, and restarting.

Fix: The interactive wizard walks users through provider selection, API key entry, base URL (for OpenAI-compat), and model name — all with prompts and validation. Settings persist in ~/.claw/settings.json, so they survive across sessions. Ctrl+P enables in-session provider hot-swap without restarting.

No persistent auth — re-enter credentials every session

Before: API keys entered as environment variables are lost when the terminal closes. There was no way to save them persistently without editing shell profiles. Users who don't use .env files or shell rc files had to export keys every time.

Fix: The wizard saves all settings (including API key) to ~/.claw/settings.json with 0o600 permissions. Auth resolution follows a three-tier priority: env var > .env file > stored config. Environment variables always win, so power users aren't blocked.

Model written under wrong JSON key

Before: save_user_provider_settings() wrote model nested under the provider object in settings.json, but the config reader expected it at the top level. This meant the model selection from the wizard was silently ignored on next startup.

Fix: model is now written at the top level of settings.json alongside the provider block, matching what the config reader expects.

How it works

Three-tier auth resolution

read_env_or_config() checks in order:

1. Environment variable (ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.)
2. .env file in the current directory
3. Stored config from ~/.claw/settings.json

How Ctrl+P works

Rustyline cannot chain commands or show popup menus. The implementation:

1. Ctrl+P inserts invisible sentinel character \x01
2. The Highlighter replaces it with a cyan [Provider Swap] label so the user sees feedback
3. User presses Enter → read_line() returns ReadOutcome::ProviderSwap
4. The REPL loop calls run_setup_wizard(), then hot-swaps the model and reprints the connection line

Persistence

Settings are stored in ~/.claw/settings.json:

{
  "provider": {
    "kind": "xai",
    "apiKey": "xai-...",
    "baseUrl": "https://api.x.ai/v1"
  },
  "model": "grok-4"
}

File is created with 0o600 permissions. All provider fields are optional — only set values are written.

Files changed

File	What changed
runtime/src/config.rs	RuntimeProviderConfig struct, save_user_provider_settings(), clear_user_provider_settings(), I/O helpers. Model written at top level, not nested under provider.
runtime/src/config_validate.rs	provider top-level field + PROVIDER_FIELDS constant (kind, apiKey, baseUrl, model) for validation
api/src/providers/mod.rs	provider_config_value(), read_env_or_config() (3-tier fallback), stored_provider_kind(), updated detect_provider_kind()
api/src/providers/anthropic.rs	read_env_non_empty() → read_env_or_config()
api/src/providers/openai_compat.rs	Same change as anthropic.rs
commands/src/lib.rs	SlashCommand::Setup variant, spec, validation
rusty-claude-cli/src/setup_wizard.rs	New file (~226 lines). Interactive wizard: provider selection, API key, base URL, model prompts
rusty-claude-cli/src/input.rs	ReadOutcome::ProviderSwap variant, Ctrl+P → sentinel char + [Provider Swap] highlight, Enter to confirm
rusty-claude-cli/src/main.rs	CliAction::Setup, /setup REPL handler with model hot-swap, Ctrl+P→wizard dispatch

Test plan

• cargo test --workspace — all tests pass
• cargo clippy --workspace --all-targets -- -D warnings — clean
• claw setup — wizard runs interactively, saves to ~/.claw/settings.json
• /setup in REPL — wizard runs, model hot-swaps, connection line reprints
• Ctrl+P in REPL — shows [Provider Swap], Enter launches wizard
• Start REPL without env vars but with stored config — auth works from stored config
• Start REPL with env vars AND stored config — env vars take priority
• Non-interactive terminal — claw setup errors with clear message
• model field read correctly from top level of settings.json on startup

💘 Generated with Crush