fast-resume

🥈Silver

Fast-resume is a Python-based CLI tool that helps developers quickly locate and resume specific coding agent sessions. It benefits developers and operations teams by streamlining workflows and reducing time spent searching for previous work. The tool connects to Claude agents and integrates with existing coding environments.

6910Updated 2mo ago

Intermediate30min to implementautomation

Saves ~15 min per use

Quick InstallView Source

git clone https://github.com/angristan/fast-resume.git

Works with:

Claude

Overview

About This Skill

How to Use

[{"step":"Install the fast-resume CLI tool using pip: `pip install fast-resume` or via your package manager.","tip":"Ensure you have Python 3.8+ and access to your coding agent's session storage directory."},{"step":"Run a search with relevant filters to locate your target session: `fast-resume --project [PROJECT_NAME] --time [PERIOD]`","tip":"Use multiple filters like --language, --tags, or --session-id for precise results. Combine with --verbose for detailed output."},{"step":"Review the session details and copy the resume command provided by the tool.","tip":"Pay attention to the 'Key files in context' section to verify this is the right session before resuming."},{"step":"Execute the resume command in your terminal or coding agent interface to continue working.","tip":"If using Claude Code, the command will typically be `claude --resume [SESSION_ID]`"},{"step":"Verify the session resumed correctly by checking the loaded files and agent context.","tip":"Look for the agent's previous notes or work-in-progress comments to confirm you're in the right place."}]

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/angristan/fast-resume

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Use the fast-resume CLI tool to locate and resume a coding agent session for [PROJECT_NAME] from the last [TIME_PERIOD]. Filter sessions by [LANGUAGE] and [TAGS] if applicable. Provide the exact command to run and summarize the key details of the resumed session.

Example Output

```bash
$ fast-resume --project "E-commerce API" --time "last 7 days" --language "Python" --tags "authentication,database"

Resumed session: 'E-commerce API - Authentication Refactor'
Session ID: claudecode-20240515-142233
Tags: authentication, database, refactor
Language: Python
Last active: 2 days ago
Key files in context:
- /src/auth/models.py (modified 3 days ago)
- /tests/test_auth.py (modified 1 day ago)
- /docs/api_spec.md (viewed 5 hours ago)

Next steps suggested by the agent:
1. Review the failing test in test_auth.py (line 42)
2. Implement JWT token refresh logic in models.py
3. Update API spec with new endpoint /refresh

To continue where you left off, run:
$ claude --resume claudecode-20240515-142233
```

The resumed session immediately loaded the authentication refactor project with all relevant files and test failures in context. The agent's previous work on JWT token handling was preserved, including partial implementations in models.py and corresponding test cases. The API specification document was also available, showing the planned endpoint structure. This saved approximately 20 minutes of setup time compared to starting a new session.