--resume

Rehydrate the scrollback from a previous session JSONL file under `~/.deltaforge/sessions/`. With no value loads the most recent file; with an explicit path loads that file. Ignored under --classic.

Syntax

--resume [<PATH>]

Description

## Overview `--resume` rehydrates the interactive shell's scrollback pane from a previously persisted session file. Each interactive session writes a JSONL scrollback file under `~/.deltaforge/sessions/` with a timestamped filename. When the flag is given with no value, the CLI picks the most recent file by modification time. When given with an explicit path, that file is loaded. This makes it cheap to re-enter a working context after a crash, a disconnect, or a machine reboot without losing the scrollback of recent queries and results. ## Behavior - Without a value: the newest file in `~/.deltaforge/sessions/` is loaded. If the directory is empty or missing, the shell starts with empty scrollback. - With a value: the given path is loaded. A missing or unreadable path produces a warning in the shell's status indicators and the shell starts with empty scrollback. - Scrollback entries are replayed into the display only; the statements are not re-executed against the engine. - Ignored when `--classic` is set because classic mode does not persist scrollback files. - Compatible with `--profile`, `--node`, `--control-url`, and the credential flags. The rehydrated view comes from local state; the live connection uses whatever URLs and identity the other flags resolve to. ## Compatibility - Session files are JSONL (`*.jsonl`) under `~/.deltaforge/sessions/`. Older formats from prior builds may fail to parse and cause the CLI to fall back to empty scrollback. - The feature is available only in the interactive shell. `query` and `run` do not have a scrollback concept and ignore `--resume`.

Examples

# Resume the most recent session
delta-forge-cli --resume

# Resume a specific session file
delta-forge-cli --resume ~/.deltaforge/sessions/20260419-140001.jsonl

# Resume under a named profile
delta-forge-cli --profile production --resume

# Resume under --classic is silently ignored; this launches a fresh classic REPL
delta-forge-cli --classic --resume

Pitfalls

• `--resume` under `--classic` is silently ignored. Classic mode does not persist scrollback and has nothing to rehydrate.
• Resumed scrollback is a display artifact, not re-executed SQL. Tables and state shown in the scrollback reflect the engine state at the original session time, not now.

See Also

• CLI_SESSION_PERSISTENCE