vClutter is a high-performance Visual Studio Code extension designed to clean up complex source code, remove non-documentation comments, and optimize code structural integrity (indentation). It supports a wide range of cleanup operations, from single selections to entire project directories, increasing developer productivity.

vClutter is more than a simple text cleaner; it understands code semantics:

• Multi-Language Support: Predefined syntax profiles for over 30 programming languages.
• String Protection: Characters inside quotes (", ', `) are treated as part of the code and never removed.
• Hybrid Cleaning: Successfully removes both single-line (//, #, ;) and block comments (/* */, """ """, ``).

Important development notes are never lost:

• Advanced Filtering: Automatically detects and preserves comments containing TODO, FIXME, or HACK.
• Configurable: This protection mechanism can be disabled according to user preferences.

Organizes the visual hierarchy of code without the need for external formatters (Prettier/ESLint, etc.):

• Bracket-Based Alignment: Automatically aligns indentation based on bracket depth for C-style languages.
• Zero-Dependency: Ensures readability even if VS Code’s built-in formatter is not installed.

1. Partial Clean
   Right-click a selected code block in the editor or use the command palette to clean only that area.

2. Global File Cleanup
   Click the $(broom) vClutter icon in the Status Bar to remove comments from the entire open file in seconds.

3. Batch Folder Sweep
   Right-click a folder in the Explorer panel and run the Sweep Folder command to clean hundreds of files across a project in one operation.

vClutter can be fully customized to match your workflow:

If you don't want to deal with the source code, you can directly install the extension:

1. Download the vclutter-0.0.1.vsix file from this repository.
2. Open VS Code.
3. Go to the Extensions view (Ctrl+Shift+X).
4. Click the "..." (three dots) in the top right corner.
5. Select Install from VSIX... and choose the downloaded file.

git clone https://github.com/erogluyusuf/vClutter.git
cd vClutter
npm install
npm run compile

vClutter is designed for visual code cleanup. Make sure keepTODOs is enabled before removing important documentation comments. The developer is not responsible for any data loss resulting from the use of this software.

Pull requests are welcome. For major changes, please open an issue first to discuss what you plan to modify.

Distributed under the MIT License. See LICENSE for more information.

Maintained by: Yusuf Eroğlu
Code clarity, redefined.