mould

mould is a modern Terminal User Interface (TUI) tool designed for interactively generating and editing configuration files from templates. Whether you are setting up a .env file from an example, creating a docker-compose.override.yml, or editing nested JSON, YAML, or TOML configurations, mould provides a fast, Vim-inspired workflow to get your environment ready.

Features

• Universal Format Support: Handle .env, JSON, YAML, and TOML seamlessly.
• Hierarchical Flattening: Edit nested data structures (JSON, YAML, TOML) in a flat, searchable list.
• Docker Compose Integration: Automatically generate docker-compose.override.yml from docker-compose.yml.
• Vim-inspired Workflow: Navigate with j/k, edit with i, and save with :w.
• Modern UI: A polished, rounded interface featuring the Catppuccin Mocha palette.
• Highly Configurable: Customize keybindings and themes via a simple TOML configuration.
• Dynamic Alignment: Automatically aligns keys and values for perfect vertical readability.
• Default Value Visibility: Keep track of original template values while editing.
• Incremental Merging: Load existing values from an output file to continue where you left off.

Installation

Ensure you have Rust and Cargo installed, then run:

cargo install --path .

Alternatively, you can build from source:

git clone <repository_url>
cd mould
cargo build --release

The binary will be installed as mould.

Usage

Provide an input template file to start editing:

mould .env.example
mould docker-compose.yml
mould config.template.json -o config.json

Keybindings (Default)

• Normal Mode

  • j / Down: Move selection down
  • k / Up: Move selection up
  • i: Edit the value of the currently selected key (Enter Insert Mode)
  • /: Search for configuration keys (Jump to matches)
  • n: Jump to the next search match
  • N: Jump to the previous search match
  • :w or Enter: Save the current configuration to the output file
  • :q or q: Quit the application
  • :wq: Save and quit
  • Esc: Clear current command prompt

• Insert Mode

  • Type your value for the selected key.
  • Arrow keys: Navigate within the input field
  • Enter / Esc: Commit the value and return to Normal Mode

Configuration

mould can be configured using a config.toml file located in your user configuration directory (e.g., ~/.config/mould/config.toml on Linux/macOS).

Example configuration:

[keybinds]
down = "j"
up = "k"
edit = "i"
save = ":w"
quit = ":q"
normal_mode = "Esc"

[theme]
# Enable transparency to let your terminal background show through
transparent = false

# Custom color palette (Catppuccin Mocha defaults)
crust = "#11111b"
surface0 = "#313244"
surface1 = "#45475a"
text = "#cdd6f4"
blue = "#89b4fa"
green = "#a6e3a1"
lavender = "#b4befe"
mauve = "#cba6f7"
peach = "#fab387"

License

This project is licensed under the MIT License. See the LICENSE file for details.