Run builds
axs build -- <cmd>, exit codes, and the route hook for agents.
Run any command from inside a checkout:
axs build -- ./gradlew test
axs build -- npm run build
axs build -- go test ./...axs build finds the checkout root (the nearest .mb.toml, else the git top level), uploads what the machine lacks,
runs the command in the project's container and copies the outputs back. While it runs you get a status line at most
every 30 seconds, then one summary: compiler errors and failing tests first, with paths of your checkout.
| Flag | Effect |
|---|---|
--raw | Streams the full log instead of the summary |
--json | Prints the result as JSON |
--wait 9m | Stops waiting after this; the job keeps running |
--budget 6000 | Size of the summary in characters |
Flags go before --. In a team login, --team <team> before the command (or AXS_TEAM) picks the team.
Exit codes
| Code | Meaning |
|---|---|
| The command's own | The command ran |
| 75 | A machine problem, already retried once |
| 76 | Still running after --wait: continue with axs build wait <id> |
The default wait of 9 minutes fits under the time limit of an agent's shell tool.
Route hook
axs install claude|codex|cursor adds a hook that stops heavy builds and tests the agent starts locally and tells
it to rerun them as axs build -- .... It catches raw Gradle, npm or pnpm build and test, go test, and
cargo build and test.
It lets everything through when:
MB_LOCAL=1orAXS_NO_BUILD=1is set,- there is no axs login,
- the build server is down, or
- no machine of the team is online.
Leave it out with axs install <client> --no-build.