axsDocs
axs build

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.

FlagEffect
--rawStreams the full log instead of the summary
--jsonPrints the result as JSON
--wait 9mStops waiting after this; the job keeps running
--budget 6000Size 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

CodeMeaning
The command's ownThe command ran
75A machine problem, already retried once
76Still 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=1 or AXS_NO_BUILD=1 is 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.

On this page