explaingit

noluyorabi/claude-code-recap

Analysis updated 2026-05-18

25TypeScriptAudience · developerComplexity · 1/5Setup · easy

TLDR

A read only tool that lists your recent Claude Code sessions across every project on your machine and gives you a one line command to resume any of them.

Mindmap

mindmap
  root((claude-code-recap))
    What it does
      Lists past Claude Code sessions
      Works across all projects
      Shows resume command
    Tech stack
      Python standard library
      Zero dependencies
      npm install option
    Use cases
      Resume old sessions
      Reopen multiple tabs
      Track work by day
    Audience
      Claude Code users
      Developers with many repos

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

See a day by day timeline of every Claude Code session across all your project folders in one place.

USE CASE 2

Get a ready to paste command that reopens a specific past coding session exactly where you left off.

USE CASE 3

Reopen several recent sessions at once, each in its own terminal tab, after a reboot or a busy week.

What is it built with?

PythonTypeScriptnpm

How does it compare?

noluyorabi/claude-code-recap8thpark/geodecodeweb-dev/spark-ui
Stars252525
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderate
Complexity1/52/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Runs entirely offline by default, only reads existing local session log files.

License is not stated in the provided material.

In plain English

claude-code-recap is a small tool that helps people using Claude Code, Anthropic's coding assistant, find their way back into old work sessions. Claude Code already saves logs of past sessions to disk, but its built in resume command only shows sessions from the folder you are currently standing in. If you work across many project folders and forget which one had that half finished task, there was no easy way to find it again. This tool solves that by reading the session logs already saved on your machine and printing a day by day timeline of everything you worked on, across every project folder, not just the current one. For each session it lists things like the last time you were active, the full path to the project, a short summary of what the session was about, roughly how many back and forth turns happened, which git branch you were on, and which AI model you used. Most usefully, it gives you a ready to paste command that immediately reopens that exact session where you left off. There is also a pick option to jump straight into one session, and an open option that reopens several sessions at once, each in its own terminal tab. The tool is written in plain Python using only the standard library, so it has no extra dependencies and needs no build step. It works entirely offline and only reads files, never writing to your session data, unless you turn on an optional smart flag. You can install it three ways: through the Claude Code plugin marketplace, with a single npx command, or with a curl script, and all three methods install the same underlying skill. This is aimed at developers who already use Claude Code across multiple repositories and want a quick way to see what they were doing and jump back in, rather than hunting through folders trying to remember.

Copy-paste prompts

Prompt 1
Show me how to install claude-code-recap using npx and then run the /recap command.
Prompt 2
Explain what the --open flag in claude-code-recap does and how it reopens multiple terminal tabs.
Prompt 3
How does claude-code-recap find Claude Code session logs without touching my project files?
Prompt 4
Walk me through installing claude-code-recap as a Claude Code plugin from the marketplace.

Frequently asked questions

What is claude-code-recap?

A read only tool that lists your recent Claude Code sessions across every project on your machine and gives you a one line command to resume any of them.

What language is claude-code-recap written in?

Mainly TypeScript. The stack also includes Python, TypeScript, npm.

What license does claude-code-recap use?

License is not stated in the provided material.

How hard is claude-code-recap to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is claude-code-recap for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.