Configuration¶
mold stores global settings at ~/.config/mold/config.toml. The file is created automatically on first use.
Config file format¶
default_kit = "original"
default_stack = "bare"
author = ""
git_init = true
tools = ["claude"]
[custom_kits]
Settings reference¶
default_kit¶
Default: original
The kit used when --beads or --kit is not passed. Must be a registered kit name (built-in: original, beads, forge, or a custom kit).
mold config set default_kit forge
default_stack¶
Default: bare
The stack template used when --stack is not passed. Valid values: go, rust, next, bare.
mold config set default_stack go
author¶
Default: (empty)
Author name injected into template files. Used in generated go.mod, Cargo.toml, package.json, and instruction files.
mold config set author "Jane Smith"
git_init¶
Default: true
Whether mold new runs git init and creates an initial commit. Can be overridden per-command with --no-git.
mold config set git_init false
tools¶
Default: claude
Comma-separated list of AI tools to generate files for by default. Can be overridden per-command with --tools.
mold config set tools claude,cursor,copilot
custom_kits¶
Registered custom kits. Managed via mold kit add and mold kit remove -- not typically edited by hand.
[custom_kits.my-kit]
path = "/home/user/my-kits/react-kit"
Managing config¶
mold config list # Show all settings
mold config get <key> # Read a single value
mold config set <key> <value> # Set a value
mold config reset # Restore defaults
Project metadata¶
Each project created by mold also contains a .mold.toml file in the project root. This records which kit, stack, and tools were used, and is read by mold upgrade to determine what to update. This file should be committed to version control.