// configuration

Configuration

Rekord works with zero config. When you want to tune command extraction, redaction, or the stop hotkey, everything lives in one readable rekord.yaml.

rekord.yaml

By default Rekord reads ~/.rekord/rekord.yaml, falling back to a ./rekord.yaml in the current directory if present. --config <path> overrides either. Values merge over the built-in defaults.

~/.rekord/rekord.yaml

commands:
  promptPatterns:
    - "^❯\s+(.+)$"      # how to detect a prompt in output

privacy:
  redact: true            # redact on export by default
  redactPatterns:
    - "mytoken-[0-9]+"

recording:
  stopKey: "ctrl-]"       # hotkey to stop an interactive session

Read & write values

$ rekord config get privacy.redact
true
$ rekord config set recording.stopKey ctrl-x
✓ recording.stopKey = ctrl-x
$ rekord config view           # print the merged config
$ rekord config path           # print the resolved file path

▋ note

Config resolves in order: built-in defaults → rekord.yaml → command-line flags. Flags always win.