notify.conf.example

# stack-nudge user config
# Copy this file to ~/.stack-nudge/config to customise behaviour.
# Lines starting with # are comments and have no effect.

# Speak notifications aloud via the bundled StackVox TTS engine.
# The voice daemon starts automatically on first notification.
# Default: false
#STACKNUDGE_VOICE=true

# StackVox voice ID to use. Run `~/.stack-nudge/venv/bin/stackvox voices` for the full list.
# Default: af_aoede
#STACKNUDGE_VOICE_NAME=af_aoede

# StackVox playback speed (1.0 = normal).
# Default: 1.1
#STACKNUDGE_VOICE_SPEED=1.1

# Bring your editor to focus immediately when the notification fires,
# instead of waiting for you to click it.
# Default: false
#STACKNUDGE_ACTIVATE_IMMEDIATELY=true

# Show the macOS banner notification on each event.
# Set to false to suppress banners — useful when STACKNUDGE_PANEL=true and
# you'd rather interact with nudges via the floating panel.
# Default: true
#STACKNUDGE_BANNER=false

# Note: STACKNUDGE_PANEL=true is no longer required — the panel is always
# available via the hotkey below. STACKNUDGE_PANEL=false is also no-op.

# Global hotkey that focuses the panel. Modifiers: cmd, shift, opt/alt, ctrl.
# Default: cmd+opt+n  (avoids cmd+shift+n which most browsers bind to
# "New Incognito Window")
#STACKNUDGE_PANEL_HOTKEY=cmd+opt+n

# Sound played for the "agent done" event. Any name from /System/Library/Sounds/
# (without the .aiff extension). Defaults: Glass for stop, Ping for permission.
#STACKNUDGE_SOUND_STOP=Glass
#STACKNUDGE_SOUND_PERMISSION=Ping

# Suppress banner + voice when the source window is already frontmost. A
# soft chime still plays so you know the agent finished. Set to false to
# always notify regardless of focus.
# Default: true
#STACKNUDGE_MUTE_WHEN_FOCUSED=false

# Default duration (minutes) for the "Mute notifications" bell in the panel
# header and menu bar. The mute itself is temporary and resets on relaunch;
# this only sets how long a one-click mute lasts. Allowed: 15, 30, 60, 120.
# Default: 30
#STACKNUDGE_MUTE_DURATION_MIN=30

# Pill widget accent color preset. Also settable from Settings → Widget →
# "Accent color". Allowed: cyan, violet, mint, rose, system (system follows
# the macOS accent and matches the banner color).
# Default: cyan
#STACKNUDGE_THEME=violet

# Use the terminal tab's title as the session name when nothing stronger is set
# (a rename in the Sessions pane, or a name set inside the agent, both still
# win). Off by default: a tab title is whatever the program in the pane wrote,
# not proof a human chose it. Applies to on-screen labels, banners and speech;
# the Slack DM additionally requires STACKNUDGE_SLACK_DETAIL, since a tab title
# can carry local paths.
#STACKNUDGE_TAB_TITLE_NAMES=true

# What to do with permission prompts raised from inside a subagent (Claude
# Code's Task tool, Codex's spawn_agent), which otherwise look identical to the
# ones you asked for. "tag" adds the subagent's name to the banner title
# ("Claude Code · Explore"); "off" drops those events: the agent still prompts
# in its own terminal, so nothing gets auto-approved, but nothing tells you it's
# waiting either. Other agents are unaffected: their hooks carry no subagent id.
# Default: tag
#STACKNUDGE_SUBAGENT_NUDGES=off

# Log a debug line (to the launchd log) explaining voice decisions — useful
# when a notification played silently and you want to know why.
# Default: false
#STACKNUDGE_DEBUG=true