clutterxp 1.2.0__tar.gz → 1.2.1__tar.gz

clutterxp-1.2.1/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.5
+Name: clutterxp
+Version: 1.2.1
+Summary: Configurable, safe, lightweight file organizer: rules, preview, undo, watch, duplicates.
+Project-URL: Homepage, https://github.com/aigo-admin/clutterxp
+Project-URL: Documentation, https://github.com/aigo-admin/clutterxp#readme
+Project-URL: Repository, https://github.com/aigo-admin/clutterxp.git
+Project-URL: Issue Tracker, https://github.com/aigo-admin/clutterxp/issues
+Project-URL: Changelog, https://github.com/aigo-admin/clutterxp/blob/main/CHANGELOG.md
+Keywords: automation,cli,downloads,file-organizer,linux
+Classifier: Environment :: Console
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: pydantic>=2.6
+Requires-Dist: ruamel-yaml-clib>=0.2.12; platform_python_implementation == 'CPython'
+Requires-Dist: ruamel-yaml>=0.18
+Requires-Dist: typer>=0.12
+Requires-Dist: watchdog>=4.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: hypothesis>=6.100; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest-timeout>=2.3; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Provides-Extra: gui
+Requires-Dist: pyside6>=6.6; extra == 'gui'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/aigo-admin/clutterxp/0ec772e48eaf1022d81824e19f89d171e1df8640/assets/clutterxp_logo.png" alt="ClutterXP Logo" width="240">
+</p>
+
+<h1 align="center">ClutterXP</h1>
+
+<p align="center">
+  <strong>Configurable, safe, lightweight file organizer for Linux.</strong><br>
+  Tidies downloads, documents, and messy directories into place—on your terms, with zero risk of file loss.
+</p>
+
+---
+
+| Category | Badges |
+|:---|:---|
+| **Package** | [![PyPI Latest Release](https://img.shields.io/pypi/v/clutterxp.svg)](https://pypi.org/project/clutterxp/) [![Supported Python](https://img.shields.io/pypi/pyversions/clutterxp.svg)](https://pypi.org/project/clutterxp/) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/aigo-admin/clutterxp/blob/main/LICENSE) |
+| **Quality** | [![Test Suite](https://img.shields.io/badge/tests-584%20passed-brightgreen.svg)](https://github.com/aigo-admin/clutterxp) [![Code Style: Ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff) [![Checked with mypy](https://img.shields.io/badge/mypy-checked-blue.svg)](http://mypy-lang.org/) |
+| **Safety** | [![Safety: Zero Deletions](https://img.shields.io/badge/safety-zero%20deletions-10b981.svg)](https://github.com/aigo-admin/clutterxp) [![Privacy: 100% Offline](https://img.shields.io/badge/privacy-100%25%20offline-6366f1.svg)](https://github.com/aigo-admin/clutterxp) |
+
+---
+
+## What is it?
+
+**ClutterXP** is a modern, fast, and reliable file organization toolkit designed for developers, power users, and everyday Linux users who want an organized workspace. Whether your `Downloads` folder is buried under months of receipts, PDFs, installers, wallpapers, and screenshots, or you want background auto-sorting for incoming files, ClutterXP handles the job with ironclad safety guarantees:
+
+- **Never deletes or overwrites**: Files only move when the destination is safe. If a file with the same name exists, ClutterXP automatically renames the incoming file (e.g., `report (1).pdf`) or skips it. Your existing files are never destroyed.
+- **Only moves what you tell it to**: If a file does not match a configured rule, it stays untouched in its original location. No unexpected moves, no mystery dump directories.
+- **One-click instant undo**: Every operation is logged in an ACID SQLite journal. Run `clutterxp undo` (or click Undo in the GUI) to restore files to their exact original locations.
+- **100% private and offline**: Operates entirely on your local machine. No tracking, no cloud telemetry, and zero network calls.
+
+---
+
+## Table of Contents
+
+- [Main Features](#main-features)
+- [Where to Get It](#where-to-get-it)
+- [Quickstart: Desktop App](#quickstart-desktop-app)
+- [Quickstart: Command Line](#quickstart-command-line)
+- [Background Watcher Daemon](#background-watcher-daemon)
+- [Duplicate File Quarantine](#duplicate-file-quarantine)
+- [Customize Your Rules](#customize-your-rules)
+- [Cheat Sheet](#cheat-sheet)
+- [Dependencies](#dependencies)
+- [License](#license)
+
+---
+
+## Main Features
+
+- **Modern Minimalist Desktop App**: Clean obsidian-dark interface with one-click presets, visual plan previews, and real-time rule match testing.
+- **Token-Aware Rule Engine**: Intelligent keyword matching that understands camelCase, PascalCase, hyphenated names, and compound extensions (e.g. `.tar.gz`).
+- **Background Watcher**: Monitors designated folders using inotify with built-in settle and debounce to ensure browser downloads finish before moving.
+- **Duplicate Detector & Safe Quarantine**: Multi-stage duplicate detection (size -> hardlinks -> head/tail partial hash -> streaming SHA-256) with safe quarantine isolation.
+- **Instant LIFO Batch Undo**: Complete rollback capability for any batch of moves or quarantine actions.
+- **Dual CLI Aliases**: Use full `clutterxp` or short alias `cxp` interchangeably.
+
+---
+
+## Where to Get It
+
+### Binary Installation via PyPI
+
+Install ClutterXP using Python 3.10+:
+
+```bash
+# Recommended: install with modern desktop app (GUI) support
+pip install "clutterxp[gui]"
+
+# CLI-only lightweight install
+pip install clutterxp
+
+# Or on Kali Linux / Debian / Ubuntu via pipx:
+pipx install "clutterxp[gui]"
+```
+
+---
+
+## Quickstart: Desktop App
+
+Launch the visual application with:
+
+```bash
+clutterxp gui
+```
+
+The desktop app provides:
+- **Interactive Plan Preview**: Review every planned move with clear status badges before touching any files.
+- **Rule Editor with Presets**: One-click setup for common categories (Invoices, Photos, Installers) plus live matching test as you type.
+- **Duplicate Quarantine**: Safely isolate duplicate downloads without risking accidental deletion.
+- **Batch History & Undo**: Restore any previous batch with a single click.
+
+---
+
+## Quickstart: Command Line
+
+Prefer the terminal? Use `clutterxp` or the shorthand `cxp`:
+
+```bash
+# 1. Create your default starter config
+clutterxp init
+
+# 2. Test which rule matches a filename
+clutterxp rules test "invoice_march.pdf"
+
+# 3. Preview what would be organized (dry-run, touches nothing)
+clutterxp organize ~/Downloads --dry-run
+
+# 4. Organize your Downloads folder
+clutterxp organize ~/Downloads --yes
+
+# 5. Changed your mind? Undo the entire batch instantly!
+clutterxp undo --yes
+```
+
+---
+
+## Background Watcher Daemon
+
+Turn on automatic sorting. When a new file is downloaded or moved into a watched folder, ClutterXP waits until it is fully written to disk, then quietly sorts it into place:
+
+```bash
+clutterxp watch
+```
+
+You can also install it as a systemd user service:
+
+```bash
+clutterxp service install
+clutterxp service status
+```
+
+---
+
+## Duplicate File Quarantine
+
+Identify duplicate files taking up storage and safely isolate them:
+
+```bash
+clutterxp duplicates scan ~/Downloads
+```
+
+---
+
+## Customize Your Rules
+
+Rules are clean and human-readable. Group by keywords, file extensions, size, or date:
+
+- *"Move files containing `invoice` or `receipt` to `~/Documents/Invoices/{year}/{month}`"*
+- *"Move `.png` and `.jpg` with `wallpaper` to `~/Pictures/Wallpapers`"*
+- *"Move `.deb`, `.iso`, `.rpm` to `~/Downloads/Installers`"*
+
+Edit rules in the desktop GUI or directly via `clutterxp rules add`.
+
+---
+
+## Cheat Sheet
+
+| What you want to do | Command |
+|:---|:---|
+| Open the visual desktop app | `clutterxp gui` |
+| Check version | `clutterxp --version` or `cxp --version` |
+| Create default starter config | `clutterxp init` |
+| Test rule matching on a filename | `clutterxp rules test "invoice_march.pdf"` |
+| Preview organization without moving files | `cxp organize ~/Downloads --dry-run` |
+| Organize a folder | `cxp organize ~/Downloads` |
+| Undo the last batch of moves | `cxp undo` |
+| Watch a folder and sort new files automatically | `cxp watch` |
+| Install background watcher service | `cxp service install` |
+| Check background service status | `cxp service status` |
+| Scan for duplicate files | `cxp duplicates scan ~/Downloads` |
+| Check system health and file integrity | `cxp doctor` |
+| View organization history | `cxp history` |
+
+---
+
+## Dependencies
+
+- **Python**: `>= 3.10`
+- **Core CLI**: `typer`, `pydantic`, `ruamel.yaml`, `watchdog`, `platformdirs`
+- **Optional GUI**: `PySide6` (`pip install "clutterxp[gui]"`)
+
+---
+
+## License
+
+[MIT](LICENSE)

clutterxp-1.2.1/README.md

@@ -0,0 +1,186 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/aigo-admin/clutterxp/0ec772e48eaf1022d81824e19f89d171e1df8640/assets/clutterxp_logo.png" alt="ClutterXP Logo" width="240">
+</p>
+
+<h1 align="center">ClutterXP</h1>
+
+<p align="center">
+  <strong>Configurable, safe, lightweight file organizer for Linux.</strong><br>
+  Tidies downloads, documents, and messy directories into place—on your terms, with zero risk of file loss.
+</p>
+
+---
+
+| Category | Badges |
+|:---|:---|
+| **Package** | [![PyPI Latest Release](https://img.shields.io/pypi/v/clutterxp.svg)](https://pypi.org/project/clutterxp/) [![Supported Python](https://img.shields.io/pypi/pyversions/clutterxp.svg)](https://pypi.org/project/clutterxp/) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/aigo-admin/clutterxp/blob/main/LICENSE) |
+| **Quality** | [![Test Suite](https://img.shields.io/badge/tests-584%20passed-brightgreen.svg)](https://github.com/aigo-admin/clutterxp) [![Code Style: Ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff) [![Checked with mypy](https://img.shields.io/badge/mypy-checked-blue.svg)](http://mypy-lang.org/) |
+| **Safety** | [![Safety: Zero Deletions](https://img.shields.io/badge/safety-zero%20deletions-10b981.svg)](https://github.com/aigo-admin/clutterxp) [![Privacy: 100% Offline](https://img.shields.io/badge/privacy-100%25%20offline-6366f1.svg)](https://github.com/aigo-admin/clutterxp) |
+
+---
+
+## What is it?
+
+**ClutterXP** is a modern, fast, and reliable file organization toolkit designed for developers, power users, and everyday Linux users who want an organized workspace. Whether your `Downloads` folder is buried under months of receipts, PDFs, installers, wallpapers, and screenshots, or you want background auto-sorting for incoming files, ClutterXP handles the job with ironclad safety guarantees:
+
+- **Never deletes or overwrites**: Files only move when the destination is safe. If a file with the same name exists, ClutterXP automatically renames the incoming file (e.g., `report (1).pdf`) or skips it. Your existing files are never destroyed.
+- **Only moves what you tell it to**: If a file does not match a configured rule, it stays untouched in its original location. No unexpected moves, no mystery dump directories.
+- **One-click instant undo**: Every operation is logged in an ACID SQLite journal. Run `clutterxp undo` (or click Undo in the GUI) to restore files to their exact original locations.
+- **100% private and offline**: Operates entirely on your local machine. No tracking, no cloud telemetry, and zero network calls.
+
+---
+
+## Table of Contents
+
+- [Main Features](#main-features)
+- [Where to Get It](#where-to-get-it)
+- [Quickstart: Desktop App](#quickstart-desktop-app)
+- [Quickstart: Command Line](#quickstart-command-line)
+- [Background Watcher Daemon](#background-watcher-daemon)
+- [Duplicate File Quarantine](#duplicate-file-quarantine)
+- [Customize Your Rules](#customize-your-rules)
+- [Cheat Sheet](#cheat-sheet)
+- [Dependencies](#dependencies)
+- [License](#license)
+
+---
+
+## Main Features
+
+- **Modern Minimalist Desktop App**: Clean obsidian-dark interface with one-click presets, visual plan previews, and real-time rule match testing.
+- **Token-Aware Rule Engine**: Intelligent keyword matching that understands camelCase, PascalCase, hyphenated names, and compound extensions (e.g. `.tar.gz`).
+- **Background Watcher**: Monitors designated folders using inotify with built-in settle and debounce to ensure browser downloads finish before moving.
+- **Duplicate Detector & Safe Quarantine**: Multi-stage duplicate detection (size -> hardlinks -> head/tail partial hash -> streaming SHA-256) with safe quarantine isolation.
+- **Instant LIFO Batch Undo**: Complete rollback capability for any batch of moves or quarantine actions.
+- **Dual CLI Aliases**: Use full `clutterxp` or short alias `cxp` interchangeably.
+
+---
+
+## Where to Get It
+
+### Binary Installation via PyPI
+
+Install ClutterXP using Python 3.10+:
+
+```bash
+# Recommended: install with modern desktop app (GUI) support
+pip install "clutterxp[gui]"
+
+# CLI-only lightweight install
+pip install clutterxp
+
+# Or on Kali Linux / Debian / Ubuntu via pipx:
+pipx install "clutterxp[gui]"
+```
+
+---
+
+## Quickstart: Desktop App
+
+Launch the visual application with:
+
+```bash
+clutterxp gui
+```
+
+The desktop app provides:
+- **Interactive Plan Preview**: Review every planned move with clear status badges before touching any files.
+- **Rule Editor with Presets**: One-click setup for common categories (Invoices, Photos, Installers) plus live matching test as you type.
+- **Duplicate Quarantine**: Safely isolate duplicate downloads without risking accidental deletion.
+- **Batch History & Undo**: Restore any previous batch with a single click.
+
+---
+
+## Quickstart: Command Line
+
+Prefer the terminal? Use `clutterxp` or the shorthand `cxp`:
+
+```bash
+# 1. Create your default starter config
+clutterxp init
+
+# 2. Test which rule matches a filename
+clutterxp rules test "invoice_march.pdf"
+
+# 3. Preview what would be organized (dry-run, touches nothing)
+clutterxp organize ~/Downloads --dry-run
+
+# 4. Organize your Downloads folder
+clutterxp organize ~/Downloads --yes
+
+# 5. Changed your mind? Undo the entire batch instantly!
+clutterxp undo --yes
+```
+
+---
+
+## Background Watcher Daemon
+
+Turn on automatic sorting. When a new file is downloaded or moved into a watched folder, ClutterXP waits until it is fully written to disk, then quietly sorts it into place:
+
+```bash
+clutterxp watch
+```
+
+You can also install it as a systemd user service:
+
+```bash
+clutterxp service install
+clutterxp service status
+```
+
+---
+
+## Duplicate File Quarantine
+
+Identify duplicate files taking up storage and safely isolate them:
+
+```bash
+clutterxp duplicates scan ~/Downloads
+```
+
+---
+
+## Customize Your Rules
+
+Rules are clean and human-readable. Group by keywords, file extensions, size, or date:
+
+- *"Move files containing `invoice` or `receipt` to `~/Documents/Invoices/{year}/{month}`"*
+- *"Move `.png` and `.jpg` with `wallpaper` to `~/Pictures/Wallpapers`"*
+- *"Move `.deb`, `.iso`, `.rpm` to `~/Downloads/Installers`"*
+
+Edit rules in the desktop GUI or directly via `clutterxp rules add`.
+
+---
+
+## Cheat Sheet
+
+| What you want to do | Command |
+|:---|:---|
+| Open the visual desktop app | `clutterxp gui` |
+| Check version | `clutterxp --version` or `cxp --version` |
+| Create default starter config | `clutterxp init` |
+| Test rule matching on a filename | `clutterxp rules test "invoice_march.pdf"` |
+| Preview organization without moving files | `cxp organize ~/Downloads --dry-run` |
+| Organize a folder | `cxp organize ~/Downloads` |
+| Undo the last batch of moves | `cxp undo` |
+| Watch a folder and sort new files automatically | `cxp watch` |
+| Install background watcher service | `cxp service install` |
+| Check background service status | `cxp service status` |
+| Scan for duplicate files | `cxp duplicates scan ~/Downloads` |
+| Check system health and file integrity | `cxp doctor` |
+| View organization history | `cxp history` |
+
+---
+
+## Dependencies
+
+- **Python**: `>= 3.10`
+- **Core CLI**: `typer`, `pydantic`, `ruamel.yaml`, `watchdog`, `platformdirs`
+- **Optional GUI**: `PySide6` (`pip install "clutterxp[gui]"`)
+
+---
+
+## License
+
+[MIT](LICENSE)

{clutterxp-1.2.0 → clutterxp-1.2.1}/pyproject.toml

@@ -44,6 +44,13 @@ cxp = "clutterxp.cli.app:main"
 [project.gui-scripts]
 clutterxp-gui = "clutterxp.gui.app:main"
 
+[project.urls]
+Homepage = "https://github.com/aigo-admin/clutterxp"
+Documentation = "https://github.com/aigo-admin/clutterxp#readme"
+Repository = "https://github.com/aigo-admin/clutterxp.git"
+"Issue Tracker" = "https://github.com/aigo-admin/clutterxp/issues"
+Changelog = "https://github.com/aigo-admin/clutterxp/blob/main/CHANGELOG.md"
+
 [tool.hatch.version]
 path = "src/clutterxp/__init__.py"
 

{clutterxp-1.2.0 → clutterxp-1.2.1}/src/clutterxp/__init__.py

@@ -1,4 +1,4 @@
 """ClutterXP - configurable, safe, fast file organizer."""
 
-__version__ = "1.2.0"
+__version__ = "1.2.1"
 

clutterxp-1.2.0/PKG-INFO

@@ -1,149 +0,0 @@
-Metadata-Version: 2.5
-Name: clutterxp
-Version: 1.2.0
-Summary: Configurable, safe, lightweight file organizer: rules, preview, undo, watch, duplicates.
-Keywords: automation,cli,downloads,file-organizer,linux
-Classifier: Environment :: Console
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python :: 3
-Classifier: Topic :: System :: Filesystems
-Classifier: Topic :: Utilities
-Requires-Python: >=3.10
-Requires-Dist: platformdirs>=4.0
-Requires-Dist: pydantic>=2.6
-Requires-Dist: ruamel-yaml-clib>=0.2.12; platform_python_implementation == 'CPython'
-Requires-Dist: ruamel-yaml>=0.18
-Requires-Dist: typer>=0.12
-Requires-Dist: watchdog>=4.0
-Provides-Extra: dev
-Requires-Dist: build>=1.0; extra == 'dev'
-Requires-Dist: hypothesis>=6.100; extra == 'dev'
-Requires-Dist: mypy>=1.10; extra == 'dev'
-Requires-Dist: pytest-cov>=5; extra == 'dev'
-Requires-Dist: pytest-timeout>=2.3; extra == 'dev'
-Requires-Dist: pytest>=8; extra == 'dev'
-Requires-Dist: ruff>=0.5; extra == 'dev'
-Provides-Extra: gui
-Requires-Dist: pyside6>=6.6; extra == 'gui'
-Description-Content-Type: text/markdown
-
-# ClutterXP
-
-> **Tired of a messy Downloads folder?** ClutterXP quietly tidies your files into the right place—on your terms, without ever losing a single file.
-
----
-
-Whether your `Downloads` folder is buried under months of receipts, PDFs, wallpapers, installers, and screenshots, or you just want your desktop kept neat, **ClutterXP** does the heavy lifting for you.
-
-Use the **clean visual desktop app** or run quick commands from your terminal.
-
----
-
-## 🛡️ Why you can actually trust it
-
-Most file cleanup tools feel risky—what if they delete something important or move a file you didn't want touched? We built ClutterXP with ironclad safety guarantees:
-
-- **Never deletes or overwrites**: Files only move if the destination is safe. If a file with the same name already exists, ClutterXP renames the new one (e.g. `report (1).pdf`) or skips it. Your existing files are never replaced or destroyed.
-- **Only moves what you tell it to**: If a file doesn't match a rule you created, it stays exactly where it is. No surprise moves, no mystery "unsorted" dump folders.
-- **One-click instant undo**: Every action is saved in a local journal. If you ever change your mind, `clutterxp undo` (or a single click in the app) puts every file right back where it was originally.
-- **100% private and offline**: Runs completely on your machine. No accounts, no cloud sync, no tracking, and zero internet requests.
-
----
-
-## ⚡ Getting Started
-
-### 1. Installation
-
-Install ClutterXP with Python (3.10+):
-
-```bash
-# Recommended: install with desktop app (GUI) support
-pip install "clutterxp[gui]"
-
-# Or on Kali Linux / Debian using pipx:
-pipx install .
-```
-
-### 2. Choose how you want to use it
-
-#### Option A: The Desktop App
-Just run:
-```bash
-clutterxp gui
-```
-You'll get an intuitive dashboard where you can:
-- **Preview moves before they happen** with a clear interactive table.
-- **Set up simple rules** with live matching tests (type a filename and see which rule catches it instantly).
-- **Find duplicate files** and safely quarantine them without risking accidental deletion.
-- **Undo any batch** with a single button.
-
-#### Option B: The Terminal (Fast & Scriptable)
-Prefer working from the command line? Use `clutterxp` or the short alias `cxp`:
-
-```bash
-# 1. Create your default starter config
-clutterxp init
-
-# 2. Test which rule matches a filename
-clutterxp rules test "invoice_march.pdf"
-
-# 3. Preview what would be organized (dry-run, touches nothing)
-clutterxp organize ~/Downloads --dry-run
-
-# 4. Organize your Downloads folder
-clutterxp organize ~/Downloads --yes
-
-# 5. Changed your mind? Undo the entire batch instantly!
-clutterxp undo --yes
-```
-
----
-
-## Features that make life easier
-
-### Set it and forget it (Background Watcher)
-Turn on automatic sorting. Whenever a new download finishes, ClutterXP waits until it's completely written to disk, then quietly sorts it into place.
-```bash
-clutterxp watch
-```
-You can even enable it as a system background service:
-```bash
-clutterxp service install
-clutterxp service status
-```
-
-### Find and clean duplicate downloads
-Downloaded the same PDF or installer three times? ClutterXP safely identifies duplicate files taking up storage, shows you where they live, and lets you isolate them safely.
-```bash
-clutterxp duplicates scan ~/Downloads
-```
-
-### Customize your rules in seconds
-Rules are dead simple. Group by keywords, file extensions, size, or age:
-- *"Move anything with `invoice` or `receipt` to `~/Documents/Invoices`"*
-- *"Move `.png` and `.jpg` with `wallpaper` to `~/Pictures/Wallpapers`"*
-- *"Move `.deb`, `.iso`, `.rpm` to `~/Downloads/Installers`"*
-
-You can edit them directly in the visual app or via `clutterxp rules add`.
-
----
-
-## Cheat Sheet
-
-| What you want to do | Command |
-|:---|:---|
-| Open the visual desktop app | `clutterxp gui` |
-| Preview organization without moving files | `cxp organize ~/Downloads --dry-run` |
-| Organize a folder | `cxp organize ~/Downloads` |
-| Undo the last batch of moves | `cxp undo` |
-| Watch a folder and sort new files automatically | `cxp watch` |
-| Install background watcher service | `cxp service install` |
-| Scan for duplicate files | `cxp duplicates scan ~/Downloads` |
-| Check system health and file integrity | `cxp doctor` |
-| View organization history | `cxp history` |
-
----
-
-## License
-
-MIT