Skip to content

ttd config

Read and write configuration. See the Configuration guide for layering and recipes, and the configuration reference for every setting.

ttd config COMMAND

Read and write configuration.

ttd needs no setup: every option has a sensible built-in default, and config files are created only when you first write to one. Settings you do change are layered, highest precedence first:

  1. TTD_* environment variables (TTD_<SECTION>__<KEY>, e.g. TTD_BILLING__ROUNDING=up)
  2. The nearest .ttd.toml, walking up from the current directory — per-project overrides
  3. The global config file (usually ~/.config/ttd/config.toml) — your personal defaults
  4. Built-in defaults

config set writes to the global file, or to .ttd.toml with --local. config list shows every available option; add --origin to see which layer set each value. config path shows where the files live.

Commands:

  • edit: Open a config file in $EDITOR.
  • get: Print one config value.
  • list: List every available option with its effective value.
  • path: Show config file paths (global and discovered local).
  • set: Set a config value (global by default, --local for .ttd.toml here).
  • unset: Remove a key from a config file.

config get

ttd config get KEY

Print one config value.

Parameters:

  • KEY, --key: Dotted key, e.g. billing.rounding [required]

config set

ttd config set [OPTIONS] KEY VALUE

Set a config value (global by default, --local for .ttd.toml here).

Parameters:

  • KEY, --key: [required]
  • VALUE, --value: [required]
  • --local, --no-local: Target .ttd.toml in this directory [default: False]

config unset

ttd config unset [OPTIONS] KEY

Remove a key from a config file.

Parameters:

  • KEY, --key: [required]
  • --local, --no-local: Target .ttd.toml in this directory [default: False]

config list

ttd config list [OPTIONS]

List every available option with its effective value.

Parameters:

  • --origin, --no-origin: Show which layer set each key [default: False]

config path

ttd config path

Show config file paths (global and discovered local).

config edit

ttd config edit [OPTIONS]

Open a config file in $EDITOR.

Parameters:

  • --local, --no-local: Target .ttd.toml in this directory [default: False]