Package Exports

ghost-amt
ghost-amt/src/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ghost-amt) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

👻 ghost-amt

Find and clean up unused npm dependencies in your Node.js projects — quickly and safely.

🚀 Features

🔎 Detects unused dependencies and devDependencies in your project
⚠️ Warns about large packages (>1MB) that might bloat your app
🤖 Interactive CLI with colorful output and emojis
🧹 Prompt to uninstall unused packages with confirmation
🕒 Fast, zero-config scanning powered by depcheck
💻 Works with JavaScript and TypeScript projects

📦 Installation

Install globally to use anywhere:

npm install -g ghost-amt

Or run without installing:

npx ghost-amt

🧙‍♂️ Usage

Run ghost-amt inside your project root folder:

ghost-amt

You’ll see an output like this:

👻 Welcome to ghost-amt - Find and clean up unused npm dependencies

🔍 Scanning project for unused dependencies...
✅ Project scan completed!

📊 Scan Results Summary:

┌────────────────────┬───────────────────────────────┐
│ Type               │ Package Name                  │
├────────────────────┼───────────────────────────────┤
│ Unused Dependency  │ lodash                        │
│ Unused DevDependency │ jest                        │
│ Large Package (>1MB) │ puppeteer                   │
└────────────────────┴───────────────────────────────┘

🧮 Total: 2 unused packages, 1 large package

? Do you want to remove all 2 unused packages? (y/N)

⚙️ How It Works

Static code analysis: Scans your codebase to detect which dependencies are actually imported or required.
Package size detection: Checks installed package sizes to identify potentially heavy dependencies.
Interactive removal: Prompts you to safely uninstall unused packages with your confirmation.

❗ Limitations

May miss dynamic imports or requires (e.g., require(variable)).
Does not modify your source code; only cleans package.json and node_modules.
Some build tools or scripts may cause false positives.

📖 Advanced Usage

Run in CI mode (non-interactive)

ghost-amt --ci

Generate report without uninstall prompt

ghost-amt --report-only

🤝 Contributing

Contributions are very welcome!

Fork the repo
Create a feature branch (git checkout -b feature-name)
Commit your changes (git commit -m "Add feature")
Push to your branch (git push origin feature-name)
Open a Pull Request

📝 License

👤 Author

Abdullah Al Mubin