recall-cli 0.1.0

TUI session browser for AI coding assistants — GitHub Copilot CLI, Claude Code, and more
Documentation

Rust License

What is Recall?

A TUI session browser for AI coding assistants — GitHub Copilot CLI, Claude Code, and more. Browse, search, preview, and resume your past sessions across providers without memorizing UUIDs or scrolling through /resume.

Think of it as the conversation sidebar that ChatGPT and Claude have — but for your terminal.

Features

Feature Description
Multi-provider Supports Copilot CLI and Claude Code sessions in one unified view
Session list All sessions sorted by last activity, with summary and age
Live preview Checkpoints, user messages, completed tasks — at a glance
Search Fuzzy filter across summaries, directories, and message content
Resume Press Enter to launch copilot --resume <id> directly
Delete Clean up old sessions with confirmation
CLI mode --list and --count flags for scripting

Supported providers

Provider Status Session location
GitHub Copilot CLI ✅ Supported ~/.copilot/session-state/
Claude Code ✅ Supported ~/.claude/projects/

Install

# Homebrew (macOS/Linux)
brew tap OriginalMHV/tap
brew install recall

# Cargo
cargo install recall-cli

# Shell (macOS/Linux)
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/OriginalMHV/recall/releases/latest/download/recall-cli-installer.sh | sh

# From source
git clone https://github.com/OriginalMHV/recall.git
cd recall && cargo install --path .

Requires Rust >= 1.85 for building from source.

Usage

# launch the TUI
recall

# list sessions as plain text
recall --list

# get session count
recall --count

Keybindings

Key Action
↑ ↓ / j k Navigate sessions
Enter Resume selected session
/ Search sessions
d Delete session (with confirmation)
Shift+↑↓ / ← → Scroll preview panel
Tab Cycle provider filter (All → Copilot → Claude → All)
g / G Jump to first / last session
q / Esc Quit

Search mode

Key Action
Type Filter sessions
Enter / Esc Exit search
Ctrl+U Clear search

How it works

Recall uses a multi-provider architecture to discover sessions across AI coding assistants:

  • Copilot CLI: reads from ~/.copilot/session-state/, parsing workspace.yaml for metadata and events.jsonl for conversation content. Checkpoint history is pulled from checkpoints/index.md.
  • Claude Code: reads from ~/.claude/projects/, parsing JSONL conversation files for session metadata, messages, and tool usage.

Nothing is modified unless you explicitly delete a session. Recall is read-only by default.

When you hit Enter on a session, Recall exits cleanly and launches the appropriate CLI tool to resume the session.

License

MIT. See LICENSE.