smokinggun

SmokingGun

Optimization evidence for agents: find complexity hotspots and test whether a proposed change is worth making.

It keeps static findings, estimates, imported measurements, and behavior evidence distinct so agents can decide what to investigate next. Install the agent skill

The optional smokinggun skill teaches compatible agent hosts how to use the CLI. Install it with the shared Skills CLI:

The Skills CLI owns skill placement, conflict handling, and updates. SmokingGun does not modify agent configuration or install skills itself. Install the CLI

Or bootstrap one scan without a global install:

This command may contact the npm registry. SmokingGun requires Node 22.18 or later. Use the CLI

Scan a repository:

Reports include the hotspot, supporting evidence, coverage, assumptions, and the validation needed next.

The default runtime profile suppresses findings from tests, documentation, examples, and fixtures while retaining those files in repository inventory. Use --source-profile all to scan every supported source file, or --only to focus explicitly on an auxiliary area.