Skip to content

fx

Hansard reads fx session history from ~/.fx/sessions. If fx uses FX_HOME, Hansard reads the sessions folder there. The source selector is fx.

Terminal window
hansard import --source fx --since all

Automatic source selection includes fx. A custom source selection must include fx to capture later changes. Hansard reads the source files without changing them. It supports current checksummed session logs and legacy snapshot, manifest, and conversation-log formats.

  1. When the import finishes, open Sessions and selectFilter & sort.
  2. Set Source to fx and setTime to the window you imported. UseFolder to narrow the list when you use this harness in several projects.
  3. Select a conversation to check its messages, tool calls, files, commits, model, and token usage.

To keep archiving new sessions from a local harness, openSettings → Imports. Automaticfollows every supported harness installed on this computer.Custom lets you turn individual harnesses on or off. Cloud sources turn on separately under Cloud agents, and ChatGPT, Claude.ai, Gemini, and Gemini Notebook / NotebookLM exports import withImport export…. Each also has its own import command. If a conversation you expect is missing after you reset the filters, run the import command on this page again with --explain-skips where the source supports it.

  • User and assistant messages, tool calls, and tool results.
  • Recorded images, model calls, cumulative usage, and working directories.
  • Child session links, interruptions, and compaction records.
  • Raw source evidence for offline replay.

A resumed session updates its existing archive identity. A shorter or changed source cannot silently replace previously archived log history. Incomplete final log records wait for a later capture.

Synthetic tests verify automatic capture, replay, images, tools, and recovery. Native fx 0.0.17 can read and resume the synthetic fixture. Three native-generated sessions against a local scripted endpoint pass import, repeat import, offline rebuild, search, viewer payload, and Stats checks. Native tool and image generation, full rendering, and installed application acceptance remain unverified.

Superseded attempts and provisional running records remain in raw evidence. Some native tool presentations and legacy sidecars have no dedicated viewer. Missing required blobs and sessions above the 64 MiB snapshot limit report an import error. Recorded configuration does not prove which model answered.