Install
OptiPrune is a headless analyzer for TypeScript and JavaScript workspaces. Use the CLI for a quick scan or import Core when you need programmatic control.
npm install --save-dev @optiprune/cli
+npm install @optiprune/core
Run from the workspace root:
npx optiprune ./src --entry src/index.ts --dry-run
A predictable workflow
Start with a dry run, inspect high-confidence findings, then widen the scope. OptiPrune keeps analysis and mutation separate so a CI check cannot silently rewrite your repository.
1Discover
Declare entry points and let the graph reveal reachable modules.
2Review
Use high, medium, and low confidence as a review queue.
3Fix
Apply only approved changes with a reproducible command.
Configuration
Keep configuration close to the project. Plugin overrides let you force-enable a detector or disable one that does not match your runtime conventions.
{
+ "entry": ["src/index.ts"],
+ "plugins": { "nextjs-plugin": true, "nestjs-plugin": false },
+ "failOn": "high"
+}Plugins
Plugins add framework, test-runner, and tooling conventions to the graph. Browse the full inventory on the Plugins page, including source links and lifecycle hooks.
Guides and reference
For CI, use JSON or SARIF reporters. For monorepos, define workspace boundaries explicitly. For custom integrations, import the headless Core API and keep file mutation behind your own approval step.
- 
- 
- 
- 
