Configure Jazz
Choose the setup you need below. Use jazz config show to inspect current settings and
jazz config validate to check configuration and agent files. For interactive settings,
run jazz and type /settings.
- Jazz configuration controls runtime defaults, limits, output, telemetry, schedulers, peers, and webhooks.
- Config file reference lists every key
config.jsonaccepts, generated from the schema, and environment variables lists every variable Jazz reads. - CLI themes lists built-in palettes, dark and light variants, and custom theme files.
- Agent configuration selects primary and companion models, personas, context limits, capabilities, and per-agent restrictions.
- Workflows combine a prompt with scheduling and run overrides.
- Notifications send results, reminders, parked approvals and failures to Telegram, Discord, a signed webhook, or the desktop.
- Providers explains cloud and local model credentials.
- MCP, web search, and email and calendar add external capabilities.
- Plugins covers optional trusted code, per-agent enablement, secrets, and authoring.
Global configuration normally lives under ~/.jazz. A project may provide ./.jazz/config.json overrides. Read Jazz configuration before editing either file because merge precedence and secret storage differ by field.