@dowse/agent

The LLM layer of dowse — diagnosis of the top hotspots, and the closed loop that fixes them, verifies the fix, and measures how much complexity actually went down.

Most people want the CLI, not this package:

npx dowse diagnose   # why is this risky, and how would you fix it
npx dowse fix        # fix it, verify it, report the delta

Install this one only if you are embedding the loop in your own tool.

npm install @dowse/agent

import { diagnoseHotspots, fixTargets } from "@dowse/agent";

Execution is delegated to the Claude Code CLI as the first choice, so it rides on the authentication you already have and can report what a run cost. ANTHROPIC_API_KEY is the fallback when Claude Code is not installed.

The loop refuses to run with uncommitted changes, isolates work on its own branch, discards anything that fails verification or exceeds the diff limit, defaults to dry-run, and will not report a pass when it found no verification scripts to run. See Closing the loop.

ESM only. Node.js ^22.18.0 || >=24.11.0.

License

MIT