Config Reference

Config file location: ~/.config/ccmux/config.toml

Editable inline from the Settings screen in the TUI (↑/↓ to move, Enter to edit, e to open $EDITOR).

[projects]

[projects]
root = "~/Projects"   # where ccmux looks for projects

[scaffold]

[scaffold]
# Directories created by `ccmux new`. Source-code layout is left to /init.
dirs = ["docs/01_Specs", "docs/02_Architecture", "docs/03_Agent_Logs"]

# First message sent to Claude. {{name}} and {{description}} are substituted.
# Leave empty to use the built-in default.
initial_prompt = ""

create_initial_commit = true

[daemon]

[daemon]
poll_interval_seconds = 2
idle_seconds_for_needs_input = 3
listen_tailnet = false    # set true on a server-mode host
tailnet_port = 7474

[sleep]

[sleep]
# "safe" | "dangerous" | "very_dangerous"
mode = "safe"
idle_release_minutes = 10
low_battery_cutoff = 20   # dangerous mode auto-downgrades below this %
ModeBehaviour
safecaffeinate -s (AC only) on macOS; systemd-inhibit on Linux
dangerousWorks on battery; auto-downgrades when battery < low_battery_cutoff
very_dangerousLid-close override via pmset/systemctl; requires passwordless sudo

[notifications]

[notifications]
bell = true                    # terminal BEL on needs_input
moshi_suppresses_bell = false  # mute bell when moshi-hook is also reporting

Spotted an error or something out of date? Edit this page on GitHub.