SkillFoxx

Claude Code Chats Delete TUI CLI

A terminal UI to browse and bulk delete Claude Code sessions together with project memory notes.

  • 62 ★ on the repository
  • Last commit
CLI

Extended access

Why this level

  • The program irreversibly deletes session files and memory notes in `~/.claude`.
  • Install runs a script through `curl | bash`.
All reasons and checks

ataleckij/claude-chats-deleteAuthor:ataleckij

Install

Works in

Manual install

curl -sSL https://raw.githubusercontent.com/ataleckij/claude-chats-delete/main/install.sh | bash

The first install command in the README downloads the release binary, verifies SHA256 and puts it in `~/.local/bin/claude-chats`.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The program irreversibly deletes session files and memory notes in `~/.claude`.
  • Install runs a script through `curl | bash`.

This is third-party code. Review the repository files before installing.

What it does

The `claude-chats` program reads the `~/.claude` folder, shows sessions across all projects, optionally grouped by project, and deletes the chosen ones. Deletion cleans the whole disk footprint: transcript, subagents, tool results, file history, tasks, background job state, prompt history and telemetry leftovers. A separate Memory tab shows project memory notes and deletes them while keeping the `MEMORY.md` index in sync. You can copy a session UUID, point the tool at another folder via `CLAUDE_CONFIG_DIR` and view or change `cleanupPeriodDays` and `idleCompaction`. Keys follow vim style and updates come through GitHub releases.

Who it is for. Claude Code users with hundreds of accumulated sessions who need to clean up disk space and project memory.

Good fit when

  • Old sessions piled up in `~/.claude` and space must be freed.
  • The traces of a specific conversation with sensitive data must be removed.
  • Memory notes are outdated and mislead the agent.
  • You want to change how long Claude Code keeps its sessions.

Not a fit when

  • The history must be kept for review: deletion is irreversible.
  • You use a different agent rather than Claude Code.
  • Only viewing without deletion is needed.

Example request

Run claude-chats, group sessions by project and show the largest, then help choose what to delete.

Limitations

Deletion is final: there is no trash or undo, so open the sessions first and confirm the selection. The project was tested with Claude Code version 2.1.274, and the `~/.claude` folder format may change in newer versions. The install script runs through `curl | bash`, downloads a binary and verifies a SHA256 checksum, and the script can be read beforehand. Linux or macOS on x64 or ARM is required. Building from source needs Go 1.21 or newer.

How to disable. Delete the `~/.local/bin/claude-chats` binary. Sessions it removed cannot be restored, and the rest of the Claude Code data stays in place.

FAQ

What exactly is removed with a session?

The transcript, subagents, tool results, file history, tasks, background job state, prompt history and security and telemetry leftovers.

Can memory notes be deleted?

Yes, in the Memory tab: `projects/<project>/memory/*.md` notes are deleted and the `MEMORY.md` index stays in sync.

How do I use another Claude folder?

Pass the path to the program or set `CLAUDE_CONFIG_DIR`.

How does the program update?

Automatically through GitHub releases.

Where is the key list?

In `docs/keyboard-shortcuts.md`, along with tips for large chat histories.

Discussion

No questions or reviews yet.

CLI tools

claude-history searches and opens past Claude Code, Codex and Pi conversations in the terminal and gives Claude a history skill

CLIExtended access542

A Python CLI that turns Claude Code JSONL transcripts into readable HTML and Markdown with search, filters and a timeline.

CLIMinimal access1.3K

A SQLite archive of Claude Code sessions with an MCP server, a terminal UI and a web UI for finding past conversations.

CLIExtended access64

Terminal manager for Claude Code sessions: live status per session, token cost by model and project, and summaries saved on exit.

CLIExtended access124

A CLI opens a local Kanban board for Claude Code tasks with dependencies, current activity and completion notifications.

CLIExtended access769
Needs a VPN

A tmux plugin that runs a Claude Code session in a popup for each project and shows the status of every agent in an fzf picker

PluginExtended access408

README in short

A terminal app for bulk cleanup of Claude Code history: sessions, memory notes and retention settings in one window.

README badge

Report a problem