The dashboard is configured via a TOML file at ~/.agent-dashboard/settings.toml (or $AGENT_DASHBOARD_DIR/settings.toml if overridden). The installer creates this from the example file. Any missing keys fall back to sensible defaults — you only need to include the settings you want to change.
Full reference
[banner]show_mascot=true# show the axolotl pixel artshow_quote=true# show the daily quote[notifications]enabled=false# enable desktop notifications from adapter hookssound=false# play alert sound on attention eventssilent_events=false# show notification for non-alerting stops[debug]key_log=false# write key/mouse/focus events to debug-keys.log[experimental]ascii_pet=false# show animated ASCII pet in the left paneldino_game=false# enable Chrome-style dino runner game (Shift+G)[usage]rate_limit_poll_seconds=60# how often to fetch rate limits from Anthropic API (0 = disable)
Settings table
Section
Key
Default
Description
banner
show_mascot
true
Show the axolotl pixel art in the banner
banner
show_quote
true
Show the daily quote in the banner
notifications
enabled
false
Enable desktop notifications from adapter hooks
notifications
sound
false
Play alert sound on attention events
notifications
silent_events
false
Show notification for non-alerting stops
debug
key_log
false
Write key/mouse/focus events to debug-keys.log
experimental
ascii_pet
false
Show animated ASCII pet in the left panel
experimental
dino_game
false
Show Chrome-style dino runner game in the left panel (Shift+G to toggle)
usage
rate_limit_poll_seconds
60
How often (in seconds) to fetch rate-limit data from the Anthropic OAuth API. Set to 0 to disable.
Environment variables
Variable
Description
Required
AGENT_DASHBOARD_DIR
Override default state directory (~/.agent-dashboard)
No
EDITOR
Editor command for opening agent directories (default: code)