v1.1.0 — Compression, Analyze & Explain

Compressed trash, and a first look at devklean's intelligence layer: knowing not just what to delete, but why.

Added

• --compress flag/config option: compresses artifacts into an archive, verifies it's
  intact, then trashes the archive instead of the raw directory — meaningfully smaller
  disk footprint for things like node_modules. Default format is gzip (no new
  required dependency); optional zstd via pip install devklean[zstd].
• devklean explain <path>: looks up a path against a signature registry of known
  build/dependency artifacts and explains what generated it, how to regenerate it,
  and the risk involved in removing it.
• devklean analyze: scans your workspace, reports reclaimable space per artifact,
  and flags simple structural issues (e.g. conflicting lockfiles in the same project).

Fixed

• Hardlink-heavy directories (npm/pnpm-style installs) could fail --compress
  verification due to a file-count mismatch — fixed with hardlink-aware counting.
• Non-OSError failures during compression could previously escape and abort an
  entire clean --compress batch instead of failing just the one item.
• A configured default path wasn't being applied to analyze/explain.
• Clearer error message when an original directory can't be removed after its
  compressed archive was already sent to trash.

Install

​ pipx install --upgrade devklean ​

Full Changelog: v1.0.2...v1.1.0

v1.0.2 — UX & Compatibility Patch

Patch release — improved terminal compatibility and internal cleanup.

Changed

• Console output now uses click.echo() instead of print() for better Unicode and Windows terminal handling
• click added as a runtime dependency
• __main__.py fixed to correctly call main from devklean.cli.main — python -m devklean now works correctly
• Package __init__.py imports made lazy — send2trash no longer loads during unrelated imports
• Windows guard test updated to run correctly in subprocesses with PYTHONPATH=src

Install

pipx install --upgrade devklean

Full Changelog: v1.0.1...v1.0.2

v1.0.1

Patch release — two bug fixes.

Fixed

• Ctrl+C at any prompt now exits cleanly with Aborted. and exit code 130 instead of dumping a KeyboardInterrupt traceback
• doctor now correctly flags records with unrecognized strategy values (e.g. legacy "recording", "rec") as corrupt instead of reporting them as healthy

Install

pipx install --upgrade devklean

Full Changelog: v1.0.0...v1.0.1

v1.0.0

First stable release. The CLI API and behavior are now stable.

What's included

• devklean scan — discover cleanable directories with size reporting; supports --json
• devklean clean — moves items to your OS trash (never rm -rf), with confirmation and interactive selection (-i)
• devklean history — lists past cleanup operations
• devklean doctor — detects and removes corrupt metadata
• devklean <path> with no subcommand defaults to scan
• Safety layer blocks deletion of root, home, system dirs, and symlinks
• Large deletions (≥ 1 GiB) require typing DELETE
• TOML config with project + global precedence
• Supports Node.js, Next.js, Python, Rust, and more

Known limitations

• Interactive mode (-i) is Linux/macOS only — depends on curses, unavailable on Windows

Install

pipx install devklean

Full Changelog: v0.1.0...v1.0.0