CLI
Sessions
sh
axom # a session in this directory
axom "question" # one-shot: print the answer and exit| Flag | |
|---|---|
--new | Start a fresh session for this directory instead of continuing the last one |
--plain | The scrollback prompt instead of the full-screen session |
--trace | Start with the full trace visible |
--auto | Don't ask before writing files or running commands |
--session <id> | Attach to a specific session |
--url <url> | Talk to a runtime at another address (default http://127.0.0.1:8737) |
Commands
| Command | |
|---|---|
axom ui | Open Axom in your browser. --host 0.0.0.0 to reach it from another machine; --no-open to just print the URL. |
axom scan | Your hardware, the X1 lineup, and how each tier fits here. --tier <tier> checks one. |
axom init | First-run setup (runs on its own the first time). --tier <tier> installs a specific tier; --cpu runs on CPU even with a GPU; --remote <url> runs the model on an Axom node. |
axom switch <tier> | Install another tier and restart into it. |
axom search | Set up web search: private engine, Brave key, or off. |
axom run "<goal>" | Work a goal unattended and print the report. See Jobs. |
axom jobs [id] | List jobs, or show, --log, --stop, or --resume one. |
axom corpus | What's been collected and rated. --export <file> writes rated turns as JSONL; --all includes unrated ones. |
axom update | Install the newest release and reload. --check only reports. |
axom status | Is the runtime up, and what's loaded. |
axom restart | Reload the runtime. |
axom stop | Shut the runtime down. |
axom --version | Print the version. |
axom run
| Flag | |
|---|---|
--watch | Keep watch instead of finishing |
--every <30s|5m|1h> | Default wait between checks when Axom names none |
--max-turns <n> | Turn budget (default 12) |
--max-minutes <n> | Time budget (default 30; per check with --watch) |
--trace | Show every turn's trace on stderr |