by angristan
Find that one coding agent session you want to get back to!
# Add to your Claude Code skills
git clone https://github.com/angristan/fast-resumeLast scanned: 6/10/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-06-10T08:08:39.330Z",
"npmAuditRan": true,
"pipAuditRan": true
}fast-resume is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by angristan. Find that one coding agent session you want to get back to!. It has 100 GitHub stars.
Yes. fast-resume passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/angristan/fast-resume" and add it to your Claude Code skills directory (see the Installation section above).
fast-resume is primarily written in Python. It is open-source under angristan on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh fast-resume against similar tools.
No comments yet. Be the first to share your thoughts!
Search and resume conversations across Claude Code, Codex, and more, all from a single place.
Coding agents are really good right now, so I'm using a bunch of them. Sometimes I remember I, or the LLM, mentioned something specific in a previous session, and I want to go back to it.
The problem is that currently, agents do have a resume feature, but either they don't support searching, or the search is very basic (e.g., title only).
That's why I built fast-resume: a command-line tool that aggregates all your coding agent sessions into a single searchable index, so you can quickly find and resume any session.
For the best experience, Ghostty 👻 is recommended. Other terminals may have issues with interactive features and displaying images.
brew tap angristan/tap
brew install fast-resume
# Run directly (no install needed)
uvx --from fast-resume fr
# Or install permanently
uv tool install fast-resume
fr
# Open the TUI with all sessions
fr
# Pre-filter search query
fr "authentication bug"
# Filter by agent
fr -a claude
fr -a codex
# Filter by directory
fr -d myproject
# Combine filters
fr -a claude -d backend "api error"
Filter directly in the search box using keywords:
agent:claude # Filter by agent
agent:claude,codex # Multiple agents (OR)
-agent:vibe # Exclude agent
agent:claude,!codex # Include claude, exclude codex
dir:myproject # Filter by directory (substring)
dir:backend,!test # Include backend, exclude test
date:today # Sessions from today
date:yesterday # Sessions from yesterday
date:<1h # Within the last hour
date:<2d # Within the last 2 days
date:>1w # Older than 1 week
date:week # Within the last week
date:month # Within the last month
Combine keywords with free-text search:
fr "agent:claude date:<1d api bug"
fr "dir:backend -agent:vibe auth"
Autocomplete: Type agent:cl and press Tab to complete to agent:claude.
# List sessions in terminal (no TUI)
fr --no-tui
# Just list, don't offer to resume
fr --list
# Force rebuild the index
fr --rebuild
# View your usage statistics
fr --stats
Resume sessions with auto-approve / skip-permissions flags:
| Agent | Flag Added | Auto-detected |
|---|---|---|
| Claude | --dangerously-skip-permissions |
No |
| Codex | --dangerously-bypass-approvals-and-sandbox |
Yes |
| Copilot CLI | --yolo |
No |
| Vibe | --auto-approve |
Yes |
| OpenCode | (config-based) | — |
| Crush | --yolo |
No |
| VS Code Copilot | (n/a) | — |
Auto-detection: Codex and Vibe store the permissions mode in their session files. Sessions originally started in yolo mode are automatically resumed in yolo mode.
Interactive prompt: For agents that support yolo but don't store it (Claude, Copilot CLI, Crush), you'll see a modal asking whether to resume in yolo mode. Use Tab to toggle, Enter to confirm.
Force yolo: Use fr --yolo to skip the prompt and always resume in yolo mode, if supported.
Usage: fr [OPTIONS] [QUERY]
Arguments:
QUERY Search query (optional)
Options:
-a, --agent [claude|codex|copilot-cli|copilot-vscode|crush|opencode|vibe]
Filter by agent
-d, --directory TEXT Filter by directory (substring match)
--no-tui Output list to stdout instead of TUI
--list Just list sessions, don't resume
--rebuild Force rebuild the session index
--stats Show index statistics
--yolo Resume with auto-approve/skip-permissions flags
--version Show version
--help Show this message and exit
| Key | Action |
|---|---|
↑ / ↓ |
Move selection up/down |
j / k |
Move selection up/down (vim-style) |
Page Up / Page Down |
Move by 10 rows |
Enter |
Resume selected session |
/ |
Focus search input |
| Key | Action |
|---|---|
| `Ctrl+`` | Toggle preview pane |
+ / - |
Resize preview pane |
Tab |
Accept autocomplete suggestion |
c |
Copy full resume command to clipboard |
Ctrl+P |
Open command palette |
q/Esc |
Quit |
| Key | Action |
|---|---|
Tab / ← → |
Toggle selection |
Enter |
Confirm selection |
y |
Select Yolo |
n |
Select No |
Esc |
Cancel |
Run fr --stats to see analytics about your coding sessions:
Index Statistics
Total sessions 751
Total messages 13,799
Avg messages/session 18.4
Index size 15.5 MB
Index location ~/.cache/fast-resume/tantivy_index
Date range 2023-11-15 to 2025-12-22
Data by Agent
┌────────────────┬───────┬──────────┬──────────┬──────────┬──────────┬─────────────┐
│ Agent │ Files │ Disk │ Sessions │ Messages │ Content │ Data Dir │
├────────────────┼───────┼──────────┼──────────┼──────────┼──────────┼─────────────┤
│ claude │ 477 │ 312.9 MB │ 377 │ 10,415 │ 3.1 MB │ ~/.claude/… │
│ copilot-vscode │ 191 │ 146.0 MB │ 189 │ 954 │ 1.4 MB │ ~/Library/… │
│ codex │ 107 │ 23.6 MB │ 89 │ 321 │ 890.6 kB │ ~/.codex/… │
│ opencode │ 9275 │ 46.3 MB │ 72 │ 1,912 │ 597.7 kB │ ~/.local/… │
│ vibe │ 12 │ 858.2 kB │ 12 │ 138 │ 380.0 kB │ ~/.vibe/… │
│ crush │ 3 │ 1.0 MB │ 7 │ 44 │ 15.2 kB │ ~/.local/… │
│ copilot-cli │ 5 │ 417.1 kB │ 5 │ 15 │ 6.9 kB │ ~/.copilot… │
└────────────────┴───────┴──────────┴──────────┴──────────┴──────────┴─────────────┘
Activity by Day
Mon ██████████ 89
Tue ██████████ 86
Wed █████ 44
Thu ██████████████ 115
Fri █████████████ 112
Sat ████████████████████ 163
Sun █████████████████ 142
Activity by Hour
0h ▄▁ ▄▄▅▂▂▂▂▂▃▃▃▅▅█ 23h
Peak hours: 23:00 (99), 22:00 (63), 12:00 (63)
Top Directories
┌───────────────────────┬──────────┬──────────┐
│ Directory │ Sessions │ Messages │
├───────────────────────┼──────────┼──────────┤
│ ~/git/openvpn-install │ 234 │ 5,597 │
│ ~/lab/larafeed │ 158 │ 2,590 │
│ ~/lab/fast-resume │ 81 │ 2,027 │
│ ... │ │ │
└───────────────────────┴──────────┴──────────┘
┌────────────────────────────────────────────────────────────────────────────────────────┐
│ SessionSearch │
│ │
│ • Orchestrates adapters in parallel (ThreadPoolExecutor) │
│ • Compares file mtimes to detect changes (incremental updates) │
│ • Delegates search queries to Tantivy index │
└────────────────────────────────────────────────────────────────────────────────────────┘
│ │
┌────────────┴────────────┐ │
▼ ▼ ▼
┌──────────────────┐ ┌───────────────────────────────────────────────────────────────────────────────┐
│ TantivyIndex │ │ Adapters