Tutorial 4: Customize the Scaffold

~/.config/ccmux/config.toml controls what ccmux new creates and how Claude is prompted.

Change the projects root

[projects]
root = "~/code"   # or any path you prefer

Custom scaffold directories

[scaffold]
dirs = ["docs/01_Specs", "docs/02_Architecture", "docs/03_Agent_Logs"]

The default is the three-directory docs vault. ccmux intentionally leaves source-code layout to Claude’s /init — the shape depends on the language you pick. Override here only if you want to enforce a specific structure.

Custom first prompt

[scaffold]
initial_prompt = """
We're starting "{{name}}". {{description}}

Please ask me 2-3 clarifying questions about the concept, stack, and
immediate goals, then write docs/01_Specs/00_Initial_Concept.md from
my answers.
"""

{{name}} and {{description}} are substituted from ccmux new <name> -d "...". Empty string falls back to the built-in default.

Apply config changes

After editing, reload the daemon:

ccmux update

Or edit inline from the Settings screen in the TUI — ↑/↓ to move, Enter to edit, e to open $EDITOR for prose-heavy fields.

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