Search documentation

Search the Fumadocs-backed documentation index.

Utilities

CLI utilities: update, release-notes, ci upload.

CommandUse
updateInstall the latest stable CLI.
release-notesPrint release notes.
ci uploadUpload a PR-trigger artifact from CI.

update

Download and install the latest stable release (the same way the install script does) and switch ax over to it on the next run.

ax update [--print]
Argument / flagWhat it does
--printPrint the install command instead of running it.

release-notes

Print release notes as Markdown.

ax release-notes [VERSION]
Argument / flagWhat it does
[VERSION]Release version to show. Defaults to the latest.
--rawPrint the fetched Markdown without metadata banners.
--source-urlPrint only the resolved source URL.

ci upload

Upload a CI-built artifact for one source-less files: slot, keyed to the commit, so the !ax run PR trigger can stage it. Runs in your CI workflow, authenticated by an org API key (AX_API_KEY). See GitHub CI for workflow setup, repo linking, and slot naming.

ax ci upload <SLOT> <PATH>
Argument / flagWhat it does
<SLOT>Required. Source-less files: slot handle the experiment declares.
<PATH>Required. Host file or directory to upload.
--repo <owner/repo>Repo the artifact belongs to. Defaults to $GITHUB_REPOSITORY.
--commit <sha>Commit the artifact was built from. Defaults to $GITHUB_SHA.
--org <org-id>Use this org without changing the active CLI org.