​

cargo-mono

​

Why use cargo-mono

• Discover and scope affected crates with deterministic workspace analysis.
• Coordinate safe version bumps across internal dependencies.
• Run release and publish workflows with structured operator-friendly output.

​

Core capabilities

• Workspace discovery and reporting: list
• Git-aware impact analysis: changed
• Version orchestration and release commit automation: bump
• Dependency-aware publish flow with optional release tag creation: publish
• Stable output contract: --output human|json

​

Install

• cargo-mono@v<semver>

cargo binstall cargo-mono --no-confirm

- uses: taiki-e/install-action@v2
  with:
    tool: cargo-binstall
- run: cargo binstall cargo-mono --no-confirm

​

Common workflows

cargo mono list

cargo mono changed

cargo mono bump --changed --level patch --bump-dependents

cargo mono publish --changed --dry-run

[workspace.metadata.cargo-mono.publish.tag]
packages = ["nodeup", "cargo-mono"]

​

Quality and reliability

• Stable human and json output behavior across commands.
• Change detection contracts, including include/exclude path filters, direct-only mode, include-uncommitted mode, and global-impact file handling.
• Release bump behavior, including internal dependency updates, workspace dependency updates, and release commit creation without tag creation.
• Publish safety behavior, including non-publishable crate skipping, invalid package selection errors, and allowlist-based publish tag creation.

cargo test -p cargo-mono --test cli

​

Related pages

• Projects Overview
• Getting Started