CLI Reference
Every command follows the pattern hwb <command> [options]. Run hwb <command> --help for full usage details.
Commands
Section titled “Commands”hwb build
Section titled “hwb build”Build wheels from a local directory, git URL, or tarball. Supports multi-Python targets, venv or Docker isolation, and output directory selection.
hwb publish
Section titled “hwb publish”Publish built wheels to PyPI, TestPyPI, private registries, or S3-compatible storage. Handles authentication and retry logic.
hwb inspect
Section titled “hwb inspect”Examine a built wheel: metadata, entry points, dependencies, file listing, and size breakdown.
hwb github
Section titled “hwb github”Headless GitHub operations: create releases, open pull requests, file issues, and trigger workflow runs without leaving the terminal.
hwb release
Section titled “hwb release”Draft, submit, approve, publish, and roll back releases using configurable approval workflows.
hwb pipeline
Section titled “hwb pipeline”Orchestrate multi-stage build-to-release pipelines from YAML definitions. Supports stage selection, conditional execution, and parallel steps.
hwb deps
Section titled “hwb deps”Dependency graph analysis: tree visualization, license compliance checking, cycle detection, and topological build ordering.
hwb actions
Section titled “hwb actions”Generate GitHub Actions workflow files from your project configuration. Produces ready-to-commit CI/CD YAML.
hwb multirepo
Section titled “hwb multirepo”Coordinate builds, syncs, and releases across multiple repositories in a single invocation.
hwb notify
Section titled “hwb notify”Send build and release notifications to Slack, Discord, Microsoft Teams, or arbitrary webhooks.
hwb security
Section titled “hwb security”Run security scans: vulnerability auditing, SBOM generation (CycloneDX), and license compliance checks.
hwb metrics
Section titled “hwb metrics”Track build performance over time: success rates, build durations, cache hit ratios, and failure analysis.
hwb cache
Section titled “hwb cache”Manage the local LRU artifact cache. List, inspect, prune, and configure size limits.
hwb changelog
Section titled “hwb changelog”Generate changelogs from Conventional Commits between two tags or refs. Outputs grouped Markdown.