Home
Docs / CLI reference

CLI reference

The commands you need to inspect, generate, run, and re-scan.

Run a command

Use npx @usehive/cli from the application root, followed by one of the commands below. Every command also accepts -C /path/to/app to target another application root.

terminal
npx @usehive/cli inspect

Command reference

scan --dry-runPreview discovery without writing files.
scan --installReview, generate approved tools, and install generated dependencies.
scan --read-onlyApprove only supported read operations explicitly.
scan --jsonOutput machine-readable analysis without writing files.
scan --select <names>Select named capabilities from a previous scan for scripts or CI.
scan --no-scriptGenerate without changing your app's package.json.
generateRe-scan, review, and regenerate selected tools.
inspectShow the generated manifest and candidates.
devRun the generated local Streamable HTTP server.
dev --stdioRun the generated server with stdio transport.
doctorCheck the local generated setup.

When your app changes

Run generate again. HIVE reports new, changed, removed, and unchanged candidates, then asks you to review selections again. It does not silently carry approval over to changed code.

terminal
npx @usehive/cli generate

Current scope

The published CLI supports one TypeScript Next.js App Router application root at a time and generates a local MCP server. Other frameworks, automatic deployment, and production OAuth are not part of this release.