Skip to content
fsuite

⏪ freplay

Derivation chain replay — rerun a traced investigation

Section titled “Derivation chain replay — rerun a traced investigation”

freplay is part of the fsuite toolkit — a set of fourteen CLI tools built for AI coding agents.

Help output

Section titled “Help output”

The content below is the live --help output of freplay, captured at build time from the tool binary itself. It cannot drift from the source — regenerating the docs regenerates this section.

freplay — deterministic replay engine for fsuite investigation commands


USAGE
  freplay --help
  freplay --version
  freplay --self-check
  freplay record <case-slug> [--purpose "..."] [--link <type:id>]... [--replay-id N] [--new] -- <fsuite-command...>
  freplay show <case-slug> [--replay-id N] [-o pretty|json]
  freplay list <case-slug> [-o pretty|json]
  freplay export <case-slug> [--replay-id N] [-o json]
  freplay verify <case-slug> [--replay-id N] [-o pretty|json]
  freplay promote <case-slug> <replay-id>
  freplay archive <case-slug> <replay-id>


SUBCOMMANDS
  record     Run an fsuite command and record its invocation, output, and result
  show       Show a recorded replay (latest or by --replay-id)
  list       List all replays for a case
  export     Export a replay as JSON
  verify     Validate a replay without executing (check paths, tools, links)
  promote    Promote a replay to canonical status
  archive    Archive (soft-delete) a replay


OPTIONS
  --purpose  Human-readable purpose for this recording
  --link     Link this replay to a related entity (e.g. evidence:42)
  --replay-id  Select a specific replay by integer ID
  --new      Force creation of a new replay even if one exists for this command
  -o         Output format: pretty (default) or json


NOTES
  The following tools are excluded from recording:
    freplay, fmetrics
  fedit is classified read_only by default; mutating when --apply is present.
  verify exit codes: 0=pass, 1=warn, 2=fail.

See also

Section titled “See also”