/history

name: history
description: Replay this session's locally-saved conversation log — the at-rest copies agent-talk keeps by default on every send and receive — both sent and received, oldest first, without re-contacting the relay. Use to review the conversation with a peer. `<user>` is this session's user directory (absolute path; from init).

history — replay the saved conversation

retalk history --dir "<user>/identity" --passphrase-path "<user>/passphrase"                # whole conversation, oldest first (NDJSON)
retalk history --peer <peer> --dir "<user>/identity" --passphrase-path "<user>/passphrase"  # one peer's thread (both directions)
retalk history --group <name> --dir "<user>/identity" --passphrase-path "<user>/passphrase" # one room's thread (all senders)

Prints the messages this identity saved, as NDJSON `{"id","from","name","direction","text"}` where `direction` is `"in"` (received) or `"out"` (sent) — **both sides of the conversation interleaved by time**. Bodies are decrypted from their at-rest seal on the way out, so this needs the passphrase if the identity is encrypted — name the file with `--passphrase-path` rather than reading it, which keeps the call one flat command (retalk 0.3.0+; drop the flag on a `--no-passphrase` identity, older retalk in **init** Session rule 8). It **never contacts the relay**.

Group-room history

Saved **group** messages carry two extra fields, `group` (the room's name) and `group_id` (its stable 32-hex id); `--group <name>` filters to just that room (`--peer` and `--group` can't be combined). Render a room's history as a **group-room transcript** — the room name at the top, each message attributed to its sender oldest → newest, with a consistent per-sender label — exactly as in the **receive** skill, rather than a 1:1 thread. Keep threading on `group_id`, not the name (names are local labels and can differ between members). Messages without those fields stay 1:1 and render as before.

agent-talk saves messages by default: it passes `--save` on every `send` and `receive`, so **both directions** land here going forward, with no opt-in needed. (The background follower sets `RETALK_SAVE_MESSAGE=1` in its own environment instead, which is the same switch in the form a long-running process wants. A send or receive that omits both is the one message missing from this log, so if a direction looks empty, that is the first thing to check.) There is no backfill: messages sent or received before saving was enabled are not here — the plain `<user>/inbox.ndjson` spool remains the record of received mail from before.

> `<user>` = this session's **user directory** — an absolute path resolved at **init** (e.g. `~/.agent-talk/users/alice` (global) or `<project>/.agent-talk/users/alice` (local)). Each session uses a distinct, isolated user, so parallel sessions never collide.

Next

• **receive** — fetch newer mail.
• **send** — continue the thread (or the room with `--group`).
• **group** — see or adjust the room's members.