Curses picker for resuming Claude Code sessions
Project description
reclaude
A keyboard-driven curses picker for resuming Claude Code
sessions. It reads ~/.claude/history.jsonl and shows your recent project directories as an
expandable tree with sessions inline, so you can jump back into a conversation without
remembering its session id.
- Tree view of recent directories; expand one to see its individual sessions, each shown with its time and opening prompt.
- Live-session locks — directories with a running
claudeprocess are marked so you don't collide with an active session. - Worktree resurrection — sessions from deleted git worktrees can be brought back; reclaude
re-runs them via
claude --worktree, which recreates the worktree and finds the transcript. - On selection it
chdirs into the directory andexecsclaude --resume <id>(display always matches the action — the row you see is the session you get).
Install
uv tool install reclaude # recommended
pipx install reclaude
pip install reclaude
Usage
reclaude # or: python -m reclaude
| Key | Action |
|---|---|
↑ / ↓ |
Move selection |
Enter |
Expand a directory, or resume the selected session |
| type | Incrementally filter by directory / prompt text |
Ctrl-W |
Toggle showing directories whose path is gone |
Ctrl-T |
Cycle the age window (how far back to look) |
Backspace |
Delete a filter character |
q / Esc |
Quit (q quits only when the filter is empty) |
Requirements
- A POSIX system with an interactive terminal (TTY).
- Claude Code installed and on your
PATH. - Python 3.10+. No third-party dependencies (Python standard library only).
License
BSD-2-Clause. See LICENSE.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file reclaude-0.1.0.tar.gz.
File metadata
- Download URL: reclaude-0.1.0.tar.gz
- Upload date:
- Size: 21.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b50843d8c24a2891dabc0bdeb614ba464b2ff4f2e5cb0357731f9b25b8addfac
|
|
| MD5 |
e124f933fdd6b0ff4dba22175ed4218d
|
|
| BLAKE2b-256 |
777a01dea36f57081236d2fff28d2de8b44e5889b90a9383b856f9a4da1f5570
|
Provenance
The following attestation bundles were made for reclaude-0.1.0.tar.gz:
Publisher:
publish.yml on bboe/reclaude
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
reclaude-0.1.0.tar.gz -
Subject digest:
b50843d8c24a2891dabc0bdeb614ba464b2ff4f2e5cb0357731f9b25b8addfac - Sigstore transparency entry: 1741280374
- Sigstore integration time:
-
Permalink:
bboe/reclaude@2ef66742cce5d68d73d7ad9fba51affb579d00e0 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/bboe
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2ef66742cce5d68d73d7ad9fba51affb579d00e0 -
Trigger Event:
push
-
Statement type:
File details
Details for the file reclaude-0.1.0-py3-none-any.whl.
File metadata
- Download URL: reclaude-0.1.0-py3-none-any.whl
- Upload date:
- Size: 9.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
759d9fc4c0f97c782925db1ab4b8bd9bc63d62aa92f6191a300c20b263153764
|
|
| MD5 |
3e5d06cee5a98e6b90b093643c8359b9
|
|
| BLAKE2b-256 |
87b924b7b7ad08d95053ef92cb0d51663849e2f4e59ee39c9fd70220b3120c44
|
Provenance
The following attestation bundles were made for reclaude-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on bboe/reclaude
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
reclaude-0.1.0-py3-none-any.whl -
Subject digest:
759d9fc4c0f97c782925db1ab4b8bd9bc63d62aa92f6191a300c20b263153764 - Sigstore transparency entry: 1741280378
- Sigstore integration time:
-
Permalink:
bboe/reclaude@2ef66742cce5d68d73d7ad9fba51affb579d00e0 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/bboe
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2ef66742cce5d68d73d7ad9fba51affb579d00e0 -
Trigger Event:
push
-
Statement type: