---

What is Recall?

A TUI session browser for GitHub Copilot CLI and Claude Code. Browse, search, preview, and resume your past sessions without memorizing UUIDs or scrolling through /resume.

The conversation sidebar your terminal never had.

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 provider-based architecture to discover sessions from multiple CLI tools:

• 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.