All notable changes to this project are documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
CONTRIBUTING.md,SECURITY.md,CODE_OF_CONDUCT.md.- Bug-report and feature-request issue templates.
- Pull-request template.
- GitHub Actions CI: pyflakes lint + pytest matrix on macOS / Ubuntu / Windows for Python 3.8 and 3.12.
- Smoke test (
tests/test_smoke.py) covering dry-run, stale-folder removal, age-based removal, and backup creation in a temporary sessions directory. .github/FUNDING.yml.
0.1.0 - 2026-05-23
- Initial release.
- Scans Claude desktop's
claude-code-sessions/directory and removes session metadata whosecwdno longer exists. --days Nflag to also remove sessions whose last activity is older than N days.--dry-runflag to preview without making changes.--forceflag to skip the "Claude.app is running" guard.- Automatic timestamped
.tar.gzbackup before any deletion, written to$HOME. - Cross-platform: macOS, Linux, Windows.
- Homebrew install via
brew install bisovka-labs/tap/claude-recents-cleaner.