Configuration

Every documented knob is a cordis.yml field. A few internal limits (the 20,000-character result cap, the 3-level subagent depth, the 4x gap-marker threshold) are fixed; they are listed under Known limitations.

- id: dsh-replay
  name: '@zoytown/dsh-replay'
  config:
    gapCeilingMs: 1200        # longest pause replayed verbatim
    includeSubagents: true    # inline delegated sessions by default
    redaction:
      enabled: true
      rules: []               # extra regular-expression sources

Field	Default	Meaning
`gapCeilingMs`	`1200`	Pauses longer than this are clamped during playback. Pauses over 4x this value additionally get a `N later` marker in the transcript, so a long gap is never silently swallowed.
`includeSubagents`	`true`	Inline subagent sessions as collapsible blocks.
`redaction.enabled`	`true`	Scan human-triggered exports. The `session_export` tool always redacts regardless of this flag.
`redaction.rules`	`[]`	Extra regular-expression sources appended to the built-in rules. An invalid pattern fails the plugin load rather than silently not running.
`dshHome`	`$DSH_HOME`	Override the home the `replay/` directory lives under.

What redaction masks by default

Home directory paths (shortened to ~), and values matching OpenAI-style keys, GitHub tokens, AWS access key ids, Slack tokens, Google API keys, Bearer tokens, JWTs, PEM private-key blocks, and assignments to names containing PASSWORD / SECRET / TOKEN / API_KEY / ACCESS_KEY / PRIVATE_KEY.

Rules lean aggressive on purpose: an over-eager match is one click to undo in the preview, while a missed credential is already shared. Redaction is a safety net, not a guarantee — read the preview before you send a transcript anywhere.

@zoytown/dsh-replay

安装

说明文档

Configuration

What redaction masks by default