# claudedo configuration. everything tunable lives here — no hardcoded paths or
# secrets in code. loaded and validated by config.py with clear errors.

[wake]
# wake phrases for listen mode. fuzzy-matched: case/space-insensitive, lenient on
# the coined word "claudedo" (whisper renders it inconsistently). number words are
# normalized to digits before command matching.
phrases = ["claudedo", "claude do", "hey claude", "ok claude", "okay claude"]

[input]
# "listen" (default): continuous capture; only acts on utterances that start with a
#   wake phrase; all other speech is transcribed locally and discarded immediately.
#   this is the hands-free path — works while another window (a game) is focused,
#   because the trigger is your voice over the mic bridge, not a Windows keyboard
#   hook. no system-wide hotkey is installed by design.
# "ptt": push-to-talk; capture only while ptt_key is held. DESK-ONLY: it captures
#   only while the daemon's own terminal window is focused (there is deliberately no
#   global hotkey — a system-wide keyboard hook is the keylogger/cheat silhouette we
#   refuse to build). use "listen" for hands-free-while-gaming.
mode = "listen"
ptt_key = "space"

[stt]
# faster-whisper model size. "medium" is the default — biggest accuracy gain for the
# coined wake word ("claudedo" / "claude do") and fine on a strong cpu. "small" is
# faster but less accurate; "large-v3" is most accurate if medium still struggles.
model = "medium"
language = "en"
# mic device: "auto", or a sounddevice device index (integer) / substring of a
# device name. run `claudedo test-audio` to list devices.
device = "auto"
# faster-whisper compute device: "auto" (cpu here), "cpu", or "cuda".
compute = "auto"

[audio]
# capture parameters. 16 kHz mono is what whisper expects.
samplerate = 16000
channels = 1
# rms energy below this counts as silence (the VAD onset/endpoint floor).
silence_threshold = 0.012
# ignore utterances shorter than this (clicks, coughs).
min_utterance = 0.3

[vad]
# Alexa-style record-until-pause endpointing (listen mode). capture starts on speech
# onset and ends after this much trailing silence — the natural end of an utterance.
# a real pause both ends the command AND separates it from following chatter (the
# chatter becomes a separate capture that the wake gate then discards).
silence_ms = 800
# hard cap so continuous noise can't record forever.
max_seconds = 10.0

[behavior]
# dictation never auto-submits: "type <phrase>" inserts literal text only; you say
# "send" separately to submit (read-before-send).
type_autosend = false
# fuzzy match ratios (0..1). the asymmetry is deliberate: a false WAKE is cheap (it
# wakes, finds no command, does nothing), so wake is lenient; a false COMMAND fires
# the WRONG action, so commands stay tight. lower = more lenient = more matches.
# prefer expanding command synonyms over loosening command_fuzzy_threshold.
wake_fuzzy_threshold = 0.6
command_fuzzy_threshold = 0.8
# optional filler words that may precede a command and are ignored for matching:
# "select yes" / "use yes" behave like "yes". (a filler word followed by a digit is
# the select command, e.g. "select 1", and is not dropped.)
filler_words = ["select", "use", "choose"]
# when no sticky target is set and exactly ONE claude-* session is running:
#   false (default) -> require an explicit `set <name>` or one-shot `target <name>`;
#                      a bare command does nothing and tells you to set one.
#   true            -> auto-target that single session (convenience).
auto_target = false
# DEBUG ONLY — relaxes the privacy invariant. when true, the daemon console prints
# the raw transcript of EVERY utterance, including non-wake speech it would otherwise
# drop silently (shown as `heard (dropped): "<transcript>"`). use it to see exactly
# how Whisper renders your wake word, then turn it OFF. default false: non-wake speech
# is discarded without ever printing the transcript.
print_heard = false