All settings
Every setting with its type, default, accepted values and environment variable.
This list is generated from the code, so it matches the installed version. Settings explains how to change them, which source wins, and when a change takes effect.
Settings
Set any of these with claudio set <key> <value>, in a project's .claudio.json, or with its environment variable:
orchestratortextthe session that gets tasks by default, by title (a cmux workspace or a bb thread)
- default
""- accepts
- text, may be empty
- env
CLAUDIO_ORCHESTRATOR
modeltextthe brain's model, through your Claude Code login
- default
default- accepts
default·sonnet·opus·haiku- env
CLAUDIO_MODEL
efforttexthow hard the brain thinks before it answers
- default
low- accepts
low·medium·high- env
CLAUDIO_EFFORT
voicetextany Deepgram Aura-2 voice: a name such as zeus, or a full model name
- default
aura-2-orion-en- accepts
- text
- env
CLAUDIO_VOICE
earstextDeepgram Flux model; flux-general-multi for other languages
- default
flux-general-en- accepts
- text
- env
CLAUDIO_EARS
eager_eotnumberconfidence at which the brain starts on a turn early, before you have surely finished
- default
0.3- accepts
0to1- env
CLAUDIO_EAGER_EOT
eotnumberconfidence at which your turn counts as finished
- default
0.7- accepts
0to1- env
CLAUDIO_EOT
eot_timeout_msintegersilence after which your turn ends whatever the confidence
- default
1500- accepts
100to10000- env
CLAUDIO_EOT_TIMEOUT_MS
barge_inbooleantalking over it pauses it
- default
true- accepts
true·false- env
CLAUDIO_BARGE_IN
memorybooleanresume the last conversation, up to a week old
- default
true- accepts
true·false- env
CLAUDIO_MEMORY
push_to_talkbooleanthe mic stays closed until you press Enter, for one turn
- default
false- accepts
true·false- env
CLAUDIO_PUSH_TO_TALK
address_mebooleanonly turns that start with its name count, for a room with other people
- default
false- accepts
true·false- env
CLAUDIO_ADDRESS_ME
narratetextwhich sessions' finishes to narrate
- default
handed-off- accepts
handed-off·all·none- env
CLAUDIO_NARRATE
mouthtextwho speaks: Deepgram Aura, ElevenLabs, or local (Kokoro on this Mac, no key)
- default
deepgram- accepts
deepgram·elevenlabs·local- env
CLAUDIO_MOUTH
styletexthow it talks: plain, brief (one sentence) or caveman
- default
plain- accepts
plain·brief·caveman- env
CLAUDIO_STYLE
elevenlabs_voicetextElevenLabs voice id, when mouth is elevenlabs
- default
pNInz6obpgDQGcFmaJgB- accepts
- text
- env
CLAUDIO_ELEVENLABS_VOICE
local_voicetextKokoro voice, when mouth is local: am_michael, af_heart, bm_george…
- default
am_michael- accepts
- text
- env
CLAUDIO_LOCAL_VOICE
local_speednumberhow fast the local voice speaks, 0.5 to 2.0
- default
1- accepts
0.5to2- env
CLAUDIO_LOCAL_SPEED
local_modeltextKokoro model: compressed (88 MB, about twice as fast) or full (325 MB, a little cleaner)
- default
compressed- accepts
compressed·full- env
CLAUDIO_LOCAL_MODEL
code_colorsbooleanhighlight code blocks in colour; off shows them as plain text
- default
true- accepts
true·false- env
CLAUDIO_CODE_COLORS
layouttextinline, or split: your turns on the right, claudio's on the left
- default
inline- accepts
inline·split- env
CLAUDIO_LAYOUT
nametextwhat it answers to, and calls itself: one to three words
- default
claudio- accepts
- text
- env
CLAUDIO_NAME
backendtextwhere the sessions are: cmux, or bb (its threads)
- default
cmux- accepts
cmux·bb- env
CLAUDIO_BACKEND
backend picks where your sessions live, and with it what orchestrator names: a cmux workspace's title or a bb thread's title. Platforms compares them.
API keys
The keys live in secrets.json, readable only by you. A key put in config.json is moved to secrets.json, and one in a project's .claudio.json is ignored. The brain may not read secrets.json, and the settings it is shown leave the keys out.
claudio setup stores the Deepgram key. Add the ElevenLabs key to secrets.json yourself, or use the environment variables below:
deepgram_api_keytextDeepgram key, for ears and the Aura mouth
- accepts
- text
- env
DEEPGRAM_API_KEY
elevenlabs_api_keytextElevenLabs key, when mouth is elevenlabs
- accepts
- text
- env
ELEVENLABS_API_KEY