config

Manage the global workmux configuration file (~/.config/workmux/config.yaml).

config edit

Open the global configuration file in your preferred editor.

workmux config edit

Uses $VISUAL, then $EDITOR, then falls back to vi. If the configuration file does not exist yet, it is created with commented-out defaults before opening.

config path

Print the path to the global configuration file. Useful for scripting.

workmux config path
# Output: /home/user/.config/workmux/config.yaml

config reference

Print the default configuration file with all options documented. Useful for discovering available options or piping to an AI agent for context.

workmux config reference

Examples

# Edit global config
workmux config edit

# Use a specific editor
EDITOR=nano workmux config edit

# Print the config path (for use in scripts)
cat "$(workmux config path)"

# Print the default config reference
workmux config reference

See also

• Configuration guide for all available options
• init to generate a project-level .workmux.yaml