Config

The /config command opens Chippery's settings interface where you can customize your experience.

Opening Settings

/config

You can also use /settings or /preferences.

What You Can Configure

General

• Theme - Light, dark, or custom themes
• Default model - Which AI model to use
• Thinking mode - Enable or disable extended thinking for supported models
• Auto-update - Enable or disable automatic updates

Token Modes

• Mode selection - Choose between balanced, balanced-pro, frugal, or all-in
• See Modes for details

Server

• Enable/disable server mode - Run Chippery as a headless service
• Session limits - Configure maximum session duration
• Auth tokens - Manage authentication tokens
• See Server for details

Pro Features

• License activation - Enter your Pro license key
• Spend control - Set token budgets and limits

Settings File

Your settings are saved to:

~/.chippery/settings.json

While you can edit this file directly, it's recommended to use /config to ensure settings are valid.

Quick Commands

Some settings have dedicated commands for quick access:

Command	What it does
/config	Open full settings UI
/mode-balanced	Switch to balanced mode
/mode-balanced-pro	Switch to balanced-pro mode
/mode-frugal	Switch to frugal mode
/mode-all-in	Switch to all-in mode (no optimization)
/server-enable	Enable server mode
/server-disable	Disable server mode

Project Configuration

For project-specific settings (like custom agents or model overrides), create a chippery.jsonc file in your project root:

{
  "$schema": "https://chippery.ai/config.json",
  "model": "anthropic/claude-sonnet-4"
}

Project config overrides your global settings for that project only.