Configuration

Customize Synoppy CLI to fit your workflow.

Configuration File

Synoppy stores your configuration at:

path

~/.synoppy/config.json

On Windows: %USERPROFILE%\.synoppy\config.json

~/.synoppy/config.json

{
  "model": "claude-sonnet-4-6",
  "theme": "dark",
  "editor": "code",
  "useBYOK": false,
  "thinkingEnabled": false,
  "thinkingBudget": 10000
}

Option	Type	Default	Description
`model`	`string`	`"claude-sonnet-4-6"`	Default AI model
`theme`	`string`	`"dark"`	Color theme (dark, light, dracula, monokai, nord, synthwave)
`editor`	`string`	`"code"`	External editor command
`useBYOK`	`boolean`	`false`	Use Bring Your Own Key mode
`thinkingEnabled`	`boolean`	`false`	Enable extended thinking
`thinkingBudget`	`number`	`10000`	Max thinking tokens

Use the /config command during a session for interactive settings:

bash

/config

This opens a menu where you can change settings without editing the config file directly.

View current configuration:

bash

synoppy config

Set a specific value:

bash

synoppy config set model "claude-opus-4-6"

Reset to defaults:

bash

synoppy config reset

dark

light

dracula

monokai

nord

synthwave

Learn about per-project configuration with synoppy.json.