fast-resume

Name: fast-resume
Author: angristan

by angristan

Verified

Find that one coding agent session you want to get back to!

157stars

17forks

Rust

Added 6/10/2026

Installation

# Add to your Claude Code skills
git clone https://github.com/angristan/fast-resume

Getting Started

Guides for using ai agents skills like fast-resume.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 6/10/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-06-10T08:08:39.330Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

Compare with similar skills

See how fast-resume compares with popular alternatives.

fast-resume vs ecc

See comparison

fast-resume vs hermes agent

See comparison

fast-resume vs everything claude code

See comparison

README.md

Frequently Asked Questions

What is fast-resume?

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 157 GitHub stars.

Is fast-resume safe to use?

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.

How do I install fast-resume?

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

What programming language is fast-resume written in?

fast-resume is primarily written in Rust. It is open-source under angristan on GitHub, so you can review or fork the full source.

Are there alternatives to fast-resume?

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.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

257,289

echoes-vault-opencode lazyagent

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

fast-resume

Search and resume conversations across Claude Code, Codex, Pi, and more, all from one terminal UI.

Coding agents can resume previous sessions, but searching those sessions is often limited or title-only. fast-resume builds a single full-text index over your local agent history so you can find a prompt, response, project, or session and jump straight back in.

https://github.com/user-attachments/assets/60f6e128-2ae4-431d-8a87-097f600b6d04

Highlights

Search titles, directories, user messages, and assistant responses across every supported agent.
Find imperfect matches with typo-tolerant Tantivy search and exact-match ranking.
Filter by agent, directory, and date from the command line or directly in the search box.
Preview conversations, copy resume commands, or hand off directly to the original agent.
Start immediately from the existing index while changed sessions refresh in the background.
Use agent artwork, mouse controls, responsive filters, and compact layouts in the Ratatui TUI.

Supported agents

Antigravity CLI, Claude Code, Codex, Copilot CLI, Copilot in VS Code, Crush, Cursor CLI, Grok Build, Kimi Code, OpenCode, Pi, and Vibe. See how it works for storage formats and resume behavior.

Install

Homebrew is the simplest option on macOS and Linux:

brew tap angristan/tap
brew install fast-resume

Nix users can run directly from the source package:

nix run github:angristan/fast-resume

You can also install with npm or a binary wheel with uv:

npm install --global fast-resume
# or
uv tool install fast-resume

See the installation guide for Nix, npm, uvx, Cargo, supported platforms, and terminal recommendations.

Quick start

# Search all sessions interactively
fr

# Start with a query or filters
fr "authentication bug"
fr -a codex -d backend "api error"

# Search without opening the TUI
fr --list "agent:claude date:<2d auth"

# Inspect or rebuild the local index
fr --stats
fr --rebuild

Inside the TUI, use the arrow keys to select a session and press Enter to resume it. Tab completes filters or cycles agents, Ctrl+P toggles the preview, and Ctrl+Y copies the resume command.

Agent usage

Coding agents can use the stable JSON output instead of parsing the human table:

fr --json --limit 10 "dir:backend authentication bug"
fr --json --limit 10 --offset 10 "dir:backend authentication bug"

Run fr --agent-context to print the bundled Agent Skill with safe search, pagination, and resume guidance.

Documentation

Installation — packages, platforms, terminals, and upgrades
Usage — search syntax, CLI options, keybindings, yolo mode, and statistics
How it works — adapters, indexing, search, refresh safety, and resume handoff
Development — local setup, validation, project layout, and release packaging

Configuration

No configuration is required. The Tantivy index follows the XDG Base Directory specification. It lives at $XDG_CACHE_HOME/fast-resume/tantivy_index when XDG_CACHE_HOME is an absolute path, or at ~/.cache/fast-resume/tantivy_index by default. It is rebuilt automatically when its schema changes.

To reset it manually:

rm -rf "${XDG_CACHE_HOME:-$HOME/.cache}/fast-resume"
fr --rebuild

License

MIT