https://github.com/zippoxer/recall
Full-text search and resume for Claude/Codex conversations
https://github.com/zippoxer/recall
claude claude-ai claude-code claudecode codex codex-cli openai-codex openai-codex-cli
Last synced: 2 days ago
JSON representation
Full-text search and resume for Claude/Codex conversations
- Host: GitHub
- URL: https://github.com/zippoxer/recall
- Owner: zippoxer
- License: mit
- Created: 2025-11-27T22:03:56.000Z (18 days ago)
- Default Branch: main
- Last Pushed: 2025-11-30T19:41:47.000Z (15 days ago)
- Last Synced: 2025-12-01T20:58:16.790Z (14 days ago)
- Topics: claude, claude-ai, claude-code, claudecode, codex, codex-cli, openai-codex, openai-codex-cli
- Language: Rust
- Homepage:
- Size: 2.93 MB
- Stars: 44
- Watchers: 0
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-claude-code - **recall** - text search and resume for Claude/Codex conversations. (Tools & Utilities)
README
# recall [](https://github.com/hesreallyhim/awesome-claude-code)
Search and resume your Claude Code conversations. Also supports Codex, OpenCode and Factory (Droid).
**Tip**: Don't like reading? Tell your agent to use `recall search --help` and it'll search for you.
## Install
**Homebrew** (macOS/Linux):
```bash
brew install zippoxer/tap/recall
```
**WinGet** (Windows):
```bash
winget install zippoxer.recall
```
**Cargo**:
```bash
cargo install --git https://github.com/zippoxer/recall
```
**Binary**: Download from [Releases](https://github.com/zippoxer/recall/releases)
## Use
Run:
```bash
recall
```
**That's it.** Start typing to search. Enter to jump back in.
| Key | Action |
|-----|--------|
| `↑↓` | Navigate sessions |
| `Pg↑/↓` | Scroll messages |
| `Ctrl+E` | Expand message |
| `Enter` | Resume conversation |
| `Tab` | Copy session ID |
| `/` | Toggle scope (folder/everywhere) |
| `Esc` | Quit |
## Ask it to Search for You
Simply tell your agent:
```
use `recall search --help`
```
Example:
```
pls find me the last conversation where we deployed to staging, use `recall search --help`
```
## MCP
No MCP required. The `recall search` CLI fulfills the same purpose. See [Ask it to Search for You](#ask-it-to-search-for-you).
## Customize
recall's resume commands can be configured with environment variables.
For example, to resume conversations in YOLO mode, add this to your `.bashrc` or `.zshrc`:
```bash
export RECALL_CLAUDE_CMD="claude --dangerously-skip-permissions --resume {id}"
export RECALL_CODEX_CMD="codex --dangerously-bypass-approvals-and-sandbox resume {id}"
```
---
---
Made with ❤️ by [zippoxer](https://github.com/zippoxer) and Claude.