Skip to content

FrilLab/dustfril

Repository files navigation

DustFril

DustFril is a workspace for scanning, analyzing, auditing, and cleaning development artifacts.

The repository is split into a reusable Rust core crate, a CLI app, and a Tauri desktop app.

Workspace Layout

  • crates/dustfril-core: shared scanning, analysis, cleanup, and audit logic
  • apps/dustfril-cli: dfr command-line interface
  • apps/dustfril-tauri: React + Tauri desktop app shell
  • apps/dustfril-tauri/src-tauri: Tauri Rust backend wired to dustfril-core

Current Capabilities

  • Scan removable artifacts for Rust, Node.js, and Java workspaces
  • Analyze artifact size, age, and cleanup recommendation
  • Build a cleanup plan before deleting anything
  • Clean artifacts with Trash or permanent deletion mode
  • Audit Node lifecycle scripts such as preinstall and postinstall
  • Persist CLI cleanup history to the OS app data directory

Detected Artifacts

Ecosystem Detected Artifacts
Rust target/
Node.js node_modules/
Java build/

CLI Usage

Run the CLI from the workspace root:

cargo run -p dustfril-cli -- <command>

Examples:

cargo run -p dustfril-cli -- scan
cargo run -p dustfril-cli -- analyze
cargo run -p dustfril-cli -- clean --dry-run
cargo run -p dustfril-cli -- clean
cargo run -p dustfril-cli -- clean --permanent
cargo run -p dustfril-cli -- audit --node

Filter by ecosystem or pass a target path:

cargo run -p dustfril-cli -- scan . --rust
cargo run -p dustfril-cli -- analyze /path/to/workspace --node

Available commands:

  • scan [path] [--rust] [--node] [--java]
  • analyze [path] [--rust] [--node] [--java]
  • clean [path] [--dry-run] [--permanent] [--rust] [--node] [--java]
  • audit [path] [--node]

Desktop App

The desktop app currently exposes the same core workflows in a workspace browser UI:

  • scan
  • analyze
  • cleanup plan
  • cleanup execution
  • lifecycle script audit

Start the frontend app from apps/dustfril-tauri:

npm install
npm run tauri dev

Development

Run Rust tests from the workspace root:

cargo test

Roadmap

  • More ecosystem-specific caches and artifact detectors
  • Richer audit output and remediation guidance
  • Additional desktop workflows
  • Configuration and advanced filtering

License

MIT License

About

No description, website, or topics provided.

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages