Module transcript 

Transcript adapters — reading any agent CLI’s session records.

recall-echo’s claim is that the memory lifecycle is mechanical rather than on the honor system. Until this module existed that was true for exactly one editor: init installed hooks into Claude Code, and crate::jsonl parsed Claude Code’s transcript format, so a Codex or Grok user could read memory over MCP while nothing ever wrote any.

Every agent CLI already records its sessions to disk. An adapter says where those records live and how to read one; everything downstream — archival, EPHEMERAL.md, graph ingest, per-turn provenance — is unchanged, because an adapter’s only output is the Conversation the rest of the crate already speaks.

The contract every adapter owes

Transcript::parse returns what the two parties said, and nothing else:

• a human turn becomes [ConversationEntry::UserMessage] — user evidence to the confidence model,
• a model turn becomes [ConversationEntry::AssistantText] — self evidence, worth far less,
• harness text is not a turn at all. System prompts, developer instructions, injected reminders and private reasoning are dropped.

That last line is the whole reason provenance means anything. A system prompt recorded under role: "user" would enter the graph as something the user asserted, and the model’s own unasserted thinking would enter as something it concluded. Each adapter documents the verified signal it uses to tell a real turn from an injected one.

Re-exports

pub use claude_code::ClaudeCodeTranscripts;

pub use codex::CodexTranscripts;

pub use grok::GrokTranscripts;

Modules

claude_code

Claude Code transcripts — ~/.claude/projects/<project>/<session>.jsonl.

codex

Codex CLI transcripts — ~/.codex/sessions/YYYY/MM/DD/rollout-<iso>-<uuid>.jsonl.

grok

Grok CLI transcripts — ~/.grok/sessions/<percent-encoded cwd>/<session uuid>/chat_history.jsonl.

Structs

TranscriptRef

One session record on disk, as discovery found it.

Enums

Source

An agent CLI whose transcripts recall-echo can read.

Traits

Transcript

A CLI’s on-disk session records, as recall-echo reads them.

Functions

adapter_for

The adapter for one source, rooted at that CLI’s default location.

detect_installed

Every adapter whose CLI has actually recorded sessions here.