66It mirrors the convenience of ` npx ` for the Cargo ecosystem while prioritising
77` cargo-binstall ` to download prebuilt executables whenever possible.
88
9+ ## Installation
10+
11+ We recommend installing cargo-binstall as well, this significantly speeds up
12+ use of ` cargox ` :
13+
14+ ``` sh
15+ cargo install cargo-binstall
16+ cargo binstall cargox-cli
17+ ```
18+
19+ If you don’t want that then you can just ` cargo install cargox-cli ` .
20+
921## Features
1022
1123- Executes ` crate[@version] ` binaries, installing them on demand.
@@ -21,21 +33,26 @@ cargox <crate[@version]> [--] [binary-args...]
2133Examples:
2234
2335``` bash
24- # Run the latest wasm-pack, installing it if necessary
25- cargox bat ./README.md
36+ # Run the latest bat that is installed or installing the latest bat if necessary
37+ $ cargox bat ./README.md
38+
39+ $ cargox bat@latest ./README.md
40+ # If the installed bat is old we only check for newer if you do this.
41+ # This is how every foo*x* tool works. We are not being different.
2642
2743# Install and run a pinned version
28- cargox cargo-deny@0.16.3 check
44+ $ cargox cargo-deny@0.16.3 check
2945
3046# Force a reinstall, building from source instead of using cargo-binstall
31- cargox --force --build-from-source cargo-nextest
47+ $ cargox --force --build-from-source cargo-nextest
48+ # ^^ shorter: cargox -fs cargo-nextest
3249```
3350
3451> [ !TIP]
3552>
3653> - Arguments before the first positional are passed to ` cargox ` .
37- > - Arguments after ` -- ` are passed to the invoked binary.
38- > - Use ` -- ` if necessary to define the separation point.
54+ > - Arguments after the positional argument are passed to the invoked binary.
55+ > - You can use ` -- ` if necessary to define this separation point.
3956
4057### Flags
4158
0 commit comments