uncomment 3.0.2

A fast Rust-based CLI tool for removing comments from source code

uncomment

A blazing fast Rust-based command-line tool that removes comments from your source code. Perfect for cleaning up AI-generated code that comes with excessive explanations.

Why Use This?

• 🚀 Lightning Fast - Built in Rust for maximum performance
• 🎯 100% Accurate - Never accidentally removes code that looks like comments
• 🛡️ Safe by Default - Preview changes before applying them
• 🌍 Multi-language - 49 built-in languages, 306 available via tree-sitter-language-pack
• 🔧 Zero Dependencies - Downloads a self-contained binary

Installation

pip install uncomment

The installer will automatically download the appropriate pre-compiled Rust binary for your platform (Windows, macOS, or Linux).

Quick Start

Remove comments from a single file:

uncomment main.py

Preview changes without modifying files:

uncomment --dry-run src/

Process all Python files in a directory:

uncomment "src/**/*.py"

Key Features

Smart Comment Detection

Unlike simple regex-based tools, uncomment understands your code's structure:

# This comment will be removed
code = "# But this won't - it's in a string!"

Preserves Important Comments

Keeps what matters:

• TODO and FIXME comments (configurable)
• License headers and copyright notices
• Linting directives (# noqa, # type: ignore, etc.)
• Docstrings (configurable)

Perfect for Python Projects

• Handles all Python comment styles
• Preserves type hints and annotations
• Respects # pylint:, # flake8:, and other linter directives
• Works with .py, .pyw, .pyi, .pyx, and .pxd files

Common Use Cases

Clean up AI-generated code:

uncomment generated_script.py

Remove all comments including TODOs:

uncomment --remove-todo --remove-fixme module.py

Remove docstrings:

uncomment --remove-doc api.py

Process entire packages:

uncomment my_package/

Use multiple threads for large codebases:

uncomment --threads 8 entire_project/

Supported Languages

While this tool works great for Python, it also supports: 49 built-in languages including JavaScript, TypeScript, Rust, Go, Java, C/C++, Ruby, Dockerfile, Scala, Dart, and many more. 306 total languages available via tree-sitter-language-pack.

Documentation

For detailed documentation, advanced options, and examples, visit: https://github.com/Goldziher/uncomment

License

MIT - see LICENSE for details.