Sessions

fx saves conversations in ~/.fx/sessions/. Start fx for a new conversation, or use fx -c to reopen the one remembered for the current workspace.

Resume a conversation

The remembered conversation and the latest one usually match. They differ when another session receives activity without becoming the selected conversation, such as through fx ask --resume.

You can resume a session from another workspace with its ID. fx then associates it with the workspace where you opened it.

Find a session

List conversations in the current workspace:

Use fx sessions --all to include other workspaces. To inspect a saved conversation and its history, run:

fx ask can continue a saved conversation without opening the shell:

Session titles

fx creates a short title from the first usable prompt so conversations are easier to find. An untitled conversation can still receive a title after you resume it. Turn this off with session_titles: false in your profile settings or through /settings. See Usage and costs for the separate model request it uses.

Recover interrupted work

fx saves partial responses and tool progress, and retries transient provider and network failures automatically. If fx exits unexpectedly during recovery, reopen the conversation and send continue to retry, or a new prompt to move on.

For a non-interactive run:

If a saved conversation cannot open, fx doctor prints a recovery command when it can repair the problem. fx session recover <session-id> creates a separate copy and leaves the original unchanged.

Compact long sessions

fx compacts older conversation history automatically when a model request reaches its context threshold. Run /compact to do it between prompts:

See Context compaction for the exact threshold, retained history, and model requests.