axon run

Run a script headlessly. The agent boots, executes the script, then exits. No TUI is opened.

axon run <script>                  # run by name
axon run <script> --key value      # pass named arguments

Script names match the filename without extension:

axon run scout                     # runs src/scripts/scout.ts
axon run learn --domain tracing    # runs src/scripts/learn.ts with args
axon run close-plan --issueId bd-yiq

Arguments are available inside the script via args or defineArgs<{}>():

// src/scripts/learn.ts
const { domain } = defineArgs<{ domain: string }>()

axon run is the primary way to invoke automation from the CLI — cron jobs, CI steps, git hooks. All globals (axon, args) are available. If the script calls axon.ui.ask(), it receives unavailable since there is no connected host.

See Scripts for the full script authoring reference.