Skip to content

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.