# fx

> Import Vercel fx history with tools, recorded usage, images, and automatic capture.

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

## Import history

```sh
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.

## Review the import

1. When the import finishes, open **Conversations** and select **Filter & sort**.
2. Set **Source** to **fx** and set **Time** to the window you imported. Use **Folder** 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, open **Settings → Imports**. **Automatic** follows every supported harness installed on this computer. **Custom** lets you turn individual harnesses on or off. Cloud sources and account exports never run from here; each needs 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.

## Preserved history

- 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.

## Limitations

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.
