cargo-governor

CLI and public integration surface for cargo-governor.

cargo-governor is the executable crate in the workspace. It provides:

owners commands for crates.io owner management
release commands for semantic versioning, changelog generation, publish, and push
JSON output for CI and agents
MCP transport and agent context export

The CLI is the main end-user interface. If you need programmatic use inside Rust code, prefer the governor-application crate.

Installation

cargo install cargo-governor

Then authenticate with crates.io once:

cargo login

The token is stored in ~/.cargo/credentials.toml and used automatically by cargo-governor.

Release Workflow

The default UX is commit-first:

git commit -m "fix: complete release flow"

cargo-governor --dry-run release full --format json
cargo-governor release full --format json

Mutating release commands reject dirty worktrees and manifest/tag version drift by default. That keeps the release path predictable and lets the tool own the release commit, tag, and changelog changes.

Command Groups

Owners

cargo-governor owners show

cargo-governor owners check
cargo-governor owners sync --dry-run

Release

cargo-governor release status --format json
cargo-governor release analyze --format json
cargo-governor release plan --format json
cargo-governor release bump --format json
cargo-governor release publish --format json
cargo-governor release full --format json

Agent And MCP

cargo-governor agent context --format json
cargo-governor agent export-docs --output-dir .
cargo-governor mcp serve

JSON Output

Every machine-oriented command returns the same outer envelope:

{
  "schema_version": 2,
  "success": true,
  "command": "release.analyze",
  "workspace": "my-workspace",
  "data": {},
  "errors": [],
  "metrics": {
    "execution_time_ms": 12
  }
}

Owners Configuration

[workspace.metadata.governor.owners]
users = ["org-bot"]

[workspace.metadata.governor.owners.groups]
core = ["alice", "github:myorg:core-team"]

[package.metadata.governor.owners]
users = ["bob"]
groups = ["core"]
strategy = "merge"

License

MIT OR Apache-2.0

cargo-governor 2.0.3