Sessions and Persistence

Agent CLI stores local config and session data so you can continue work across runs.

Resume commands

Use these commands to continue previous sessions:

/sessions
/resume <id-or-prefix>
/new
fastfold --resume <id>
fastfold --continue
fastfold agent fork <share_id>

Local paths

Useful paths:

• config: ~/.fastfold-cli/config.json (backup: ~/.fastfold-cli/config.json.bak)
• interactive prompt history: ~/.fastfold-cli/history
• sessions: ~/.fastfold-cli/sessions/<session_id>.jsonl
• trace events: ~/.fastfold-cli/sessions/<session_id>.trace.jsonl
• imported shared files: <sandbox.output_dir>/shared_forks/<share_id>/...

Fork shared cloud sessions

fastfold agent fork <share_id> imports a shared cloud thread into your local session storage.

Notes:

• You can pass either a share ID or a full .../agents/share/<share_id> URL.
• Public-link shares can be imported without API key auth.
• Restricted-email shares require FASTFOLD_API_KEY for an allowed account.
• Use --no-files to import transcript only and skip file download.

Related pages

• Setup and provider config: Setup and local models
• Interactive slash commands: Interactive commands