Skip to main content

Claudenator

Version Python License: MIT Unit tests Code lint

The only Claude Code session manager you need

Claude Code writes a lot. Every session leaves a transcript from the main session and its subagents. Then goes the environment, file history, jobs and todos. That's tons of disk. Additionally, it auto-purges all the sessions older than 30 days, but if you decide to prevent that and keep some old sessions for longer, it can stack up a massive pile pretty quickly.

This is where Claudenator comes to the rescue. It shows all your sessions, grouped by project folder, sorts them by whatever column you like and shows tons of additional information that would help you manage them and purge only real garbage.

Claudenator in action

Features

  • Shows every session, its title, project, size, date, messages, model, git branch, tools and moar.
  • A details pane under the table, and a full-screen view for the whole story.
  • Order the table by any column and narrow it to what you look for with a filter.
  • A deleted session first goes to a Trash so it disappears but is not yet gone and can be either restored or purged for good.
  • Comes with "Deep scan" feature, that process the full transcript to give you more stats for nerds.
  • Configurable TUI with themes, layout, time formats and more.

Installation

The pipx is the recommended way to install it:

# Install pipx if not present
sudo apt install -y pipx

# Install the tool
pipx install claudenator

# Upgrade existing installation
pipx upgrade claudenator

To get the latest code, install straight from the repository:

# Install the current "master" branch
pipx install --force git+https://github.com/MarcinOrlowski/claudenator.git

# Install the "dev" branch or any other branch, tag or commit
pipx install --force git+https://github.com/MarcinOrlowski/claudenator.git@dev

The --force option is only needed if there's already existing Claudenator installation present.

License

  • Written and copyrighted ©2026 by Marcin Orlowski <mail (#) marcinorlowski (.) com>
  • This is open-source software licensed under the MIT license

Metadata

Release files for claudenator 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for claudenator 1.2.0
File Size Uploaded
claudenator-1.2.0.tar.gz 121.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for claudenator 1.2.0
File Interpreter ABI Platform
claudenator-1.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 189.2 kB

Release files / claudenator-1.2.0.tar.gz

Download URL claudenator-1.2.0.tar.gz
Size 121.8 kB
Tags Source
SHA-256 checksum
How to use checksums
32a989fcf2f107cf060bdf1d7e9a07a508ec7a3afe3a76dcd9ffb3ea850d04ec
BLAKE2b-256 checksum
How to use checksums
b6feb34503fb7444469806095d84f723b0ff5c95594ce7e1e1597acfe5bfc02c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.

Transparency log

Release files / claudenator-1.2.0-py3-none-any.whl

Download URL claudenator-1.2.0-py3-none-any.whl
Size 67.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
23543582cfa7951f7629c1bda5b4e244d69ae83ace8c859d597091dd74ea70fd
BLAKE2b-256 checksum
How to use checksums
1d145cc651a19df2d8f8a585b3165500c43f958cd5c0e315562284b7cca88522
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

1.2.0 This release

2 release files

1.1.0

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page