◆Franklin/Docs

Sessions

Persistent session history with full-text search.

How Sessions Work

Every conversation with Franklin is automatically saved as a session. Sessions are stored as JSONL files in ~/.blockrun/sessions/, making them easy to back up, inspect, or migrate. Each session captures the full message history including tool calls and their results.

Browsing History

List your recent sessions with the /history command:

bash
/history

This shows your last 20 sessions with timestamps, a preview of the first message, and the session ID.

Resuming a Session

Pick up where you left off by resuming a previous session:

bash
# Resume the most recent session
/resume

# Resume a specific session by ID
/resume abc123

The full conversation context is restored, so Franklin remembers everything from the previous session.

Full-Text Search

Search across all sessions from the CLI:

bash
franklin search "database migration"

This searches message content across all saved sessions and returns matching results with session IDs you can resume.

Search is fast

Search works directly on the JSONL files with no external database. Even with hundreds of sessions, results return in milliseconds.

Retention & Crash Safety

Franklin retains the last 20 sessions automatically. Older sessions are pruned on startup. Sessions are written incrementally — every message is flushed to disk immediately, so even if Franklin crashes mid-conversation, your history up to that point is preserved.

Storage location

All sessions live in ~/.blockrun/sessions/. Each file is a standalone JSONL document. You can copy them between machines or back them up like any other file.