Skip to main content

​
buttons config

Read and write per-user settings

​
Synopsis

Manage per-user defaults stored in ~/.buttons/settings.json. Settings are global only — personal preferences shouldn’t leak into project repos via .buttons/. Project-level knobs live on each button (e.g. ‘buttons create —timeout N’ pins a timeout for that button specifically). Known keys: 
  default-timeout   seconds used when 'buttons create' is run without
                    an explicit --timeout flag (fallback: 300)
  theme             board TUI theme: default | paper | phosphor | amber
                    (fallback: default — adapts to terminal background)
Running buttons config with no subcommand prints the current values. Resolution order for theme at TUI startup: $BUTTONS_THEME env var wins, then settings, then default. Env override keeps A/B comparison easy. Examples: 
buttons config
buttons config set default-timeout 600
buttons config set theme amber
buttons config unset theme

buttons config [flags]

​
Options

  -h, --help   help for config

​
Options inherited from parent commands

      --json       output in JSON format
      --no-input   disable all interactive prompts
      --summary    show a read-only plan/snapshot instead of mutating

​
SEE ALSO