Documentation

Commentary

agent-recall provides search, browsing, and session resume capabilities
for agent-shell conversation transcripts.

agent-shell (https://github.com/xenodium/agent-shell) automatically
saves full conversation transcripts as Markdown or org-mode files in
`.agent-shell/transcripts/' directories within your projects, or in
directories configured via `agent-recall-extra-transcript-dirs'.  Over
time these accumulate into a rich knowledge base of AI interactions,
but there's no built-in way to search across them or resume past
conversations.

agent-recall maintains a persistent index of all transcripts,
provides fast full-text search powered by ripgrep, and can resume
past agent-shell sessions from any transcript.  The index grows
automatically as you use agent-shell (via a mode hook) and can
be rebuilt from scratch with `agent-recall-reindex'.

Quick start:

  ;; First-time setup: build the index
  (setq agent-recall-search-paths '("~/projects" "~/work"))
  M-x agent-recall-reindex

  ;; Search all transcripts
  M-x agent-recall-search

  ;; Browse transcripts by project and date
  M-x agent-recall-browse

  ;; Resume a past conversation
  M-x agent-recall-resume

  ;; See stats about your transcript collection
  M-x agent-recall-stats

  ;; Auto-activate transcript-mode when visiting transcripts
  (global-agent-recall-transcript-mode 1)

Session resume setup (optional):

  ;; Embed session IDs in new transcripts for instant resume
  (add-hook 'agent-shell-mode-hook #'agent-recall-track-sessions)

  ;; Backfill session IDs into existing transcripts
  M-x agent-recall-backfill          ; dry-run (preview only)
  C-u C-u M-x agent-recall-backfill  ; write session IDs

Consumers

Reverse Dependencies

No reverse dependencies recorded.