dblt

A modern terminal UI tool to analyze and debloat developer repositories.

dblt scans a directory, detects projects and their technologies, shows you exactly how much disk space each one is consuming, and lets you safely clean up heavy build/dependency folders (node_modules, venv, target, vendor, bin, obj, Pods, ...) from a single interactive screen.

Features

  • Scan any directory and list every detected project sorted by disk usage.
  • Live size bars with physical vs logical size (semáforo: green < 500 MB, yellow < 1 GB, red > 1 GB).
  • Git integration: current branch, sync status (↑ ahead / ↓ behind), dirty marker, last commit time.
  • Git operations: view status/diffs, commit & push with Conventional Commit suggestions, switch branches.
  • Debloat: identify and delete node_modules, venv, .venv, target, vendor, bin, obj, Pods, .gradle, .bundle, vendor/bundle with confirmation.
  • Large files: find the top 5 largest files (excluding dependencies) and delete them.
  • Reinstall dependencies: regenerate node_modules, venv, etc. after cleaning.
  • Open projects in VS Code, Cursor, VSCodium, Sublime, Notepad++ or your file manager.
  • Search & filter projects by name or technology.
  • Integrated terminal per project.

Requirements

  • Python 3.9+
  • Linux, macOS or Windows (Windows uses windows-curses automatically)
  • git available in PATH for git features

Installation

pip install dblt

Or install from source:

git clone https://github.com/nikitacontreras/dblt.git
cd dblt
pip install .

Usage

dblt                     # scan the current directory
dblt /path/to/projects   # scan a specific directory

Keys

Key Action
↑/↓ Navigate projects
/ Search / filter
r Rescan
d Debloat selected project (deletes targets, requires y confirm)
l List top 5 large files
i Reinstall dependencies
g Git status / diff / commit & push
b Switch branch
o Open in editor
t Integrated terminal
H Cycle logo
q/Esc Quit

What gets deleted when debloating

Technology Targets
Node.js node_modules
Python venv, .venv
Rust target
PHP vendor
Java target, build, .gradle
C# bin, obj
Ruby .bundle, vendor/bundle
iOS Pods

Warning: debloat and file deletion are permanent. dblt always asks for confirmation, but there is no trash/undo — use at your own risk.

Development

# run tests
python -m unittest discover -s tests

# build the distribution
pip install build setuptools-scm
python -m build

License

MIT

Project links

Data verified by PyPI on Aug 10, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for nikitastrike from gravatar.com nikitastrike

Credits

Author: Nikita Contreras

GitHub Statistics

Data verified by PyPI on Aug 10, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.9

Tags

tui cli debloat cleanup disk repos

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dblt_tui-0.1.0.tar.gz (20.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dblt_tui-0.1.0-py3-none-any.whl (22.0 kB view details)

Uploaded Python 3

File details

Details for the file dblt_tui-0.1.0.tar.gz.

File metadata

  • Download URL: dblt_tui-0.1.0.tar.gz
  • Upload date:
  • Size: 20.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for dblt_tui-0.1.0.tar.gz
Algorithm Hash digest
SHA256 b569cff40d9ce72a20dc7638d157f30baa280dabf669041038a1edb438f367fb
MD5 4dbd500126b6a7591d7e91bdfa127f82
BLAKE2b-256 53019724e2f8fb66b0ee58a19a812f67a653ed5c63f26d10e8677d3cda7bc6df

See more details on using hashes here.

Provenance

The following attestation bundles were made for dblt_tui-0.1.0.tar.gz:

Publisher: release.yml on nikitacontreras/dblt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file dblt_tui-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: dblt_tui-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 22.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for dblt_tui-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 718f6f6e2ef22469e7717d45d1b59381ccb752e7b4203c2b47a394a7ed55b639
MD5 09821a17f5ff12218f9f3128615a9450
BLAKE2b-256 50969e5d933cc36f97b7b64690802a9c52ecb9d6a85e8bcaad150db9d643e04c

See more details on using hashes here.

Provenance

The following attestation bundles were made for dblt_tui-0.1.0-py3-none-any.whl:

Publisher: release.yml on nikitacontreras/dblt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 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