cargo-x

May 15, 2026 ยท View on GitHub

Build Status APACHE licensed MIT licensed crates.io Released API docs

A very simple third-party cargo subcommand to execute a custom command

Usage

Install cargo-x:

cargo install cargo-x

Upgrade an existing install:

cargo install -f cargo-x

Add commands in x.toml:

ls = "ls -ltr"
test = "cargo test --workspace --all-targets"

You can define commands in these places. Later files override earlier ones when the same command key is used:

  1. ~/.x.toml
  2. x.toml next to the current package Cargo.toml
  3. [package.metadata.x] in the current package Cargo.toml

The key x is reserved. Do not configure x = "any command".

Run a configured command:

cargo x ls
# or
cargo-x ls
# or
x ls

License

Licensed under either of these:

Contributing

Please sign a cla, thanks!