Installation

Requirements

Node.js 20+. No external CLI tools need to be on PATH — all code parsing goes through the TypeScript Compiler API bundled with the package itself, nothing is delegated to a globally installed git/tsc/anything else.

Installation

npm install -g @macrulez/devtoolz

The devtoolz command is then available from any directory. Or run it without installing:

npx @macrulez/devtoolz strip-comments src --dry-run

Quick start

devtoolz strip-comments src --dry-run --diff   # preview, see exactly what would change
devtoolz strip-comments src -y                 # actually strip

devtoolz console-strip src --dry-run           # same idea, for console.log/debugger
devtoolz dead-exports src                      # report-only, nothing to apply
devtoolz unused-deps                           # package.json vs what's actually imported
devtoolz circular-imports src                  # find import cycles
devtoolz case-check src --fix --diff --dry-run # preview a case fix

devtoolz exports-doctor                        # check package.json in the current directory
devtoolz readme-check                          # typecheck ts blocks in ./README.md

devtoolz empty-catch src                       # find catch blocks that swallow the error
devtoolz todo-report src                       # summarize TODO/FIXME/HACK comments

devtoolz scripts-check                         # package.json scripts vs README/CI mentions
devtoolz orphan-tests src                      # test files whose source disappeared

devtoolz stale-ts-ignore                       # find @ts-ignore comments suppressing nothing

devtoolz ui                                    # a web interface for the checks and the cleanup
devtoolz full-check                            # run every command, one summary table

The image commands moved to MediaToolz: npx @macrulez/mediatoolz image-batch ….

devtoolz --help lists every command with its own flags inline; devtoolz <command> --help gives one command's full flag list with defaults.