CLI Commands
The full surface of the axon CLI. Run axon --help for the live help; run axon <cmd> --help for per-command details.
Lifecycle
| Command | Description |
|---|---|
axon | Default action — starts the local daemon, opens dashboard, locks keystore (dashboard drives unlock) |
axon start | Unlock via env passphrase + start daemon in foreground |
axon --live | Start in live mode (real money) |
axon --demo | Start in demo mode (default) |
axon --host <host> | Bind to a non-default host (requires --i-understand-network-exposure) |
axon status | Print daemon status + wallet address (queries running daemon) |
axon doctor | Check keystore, config, RPC, venues, agent runtimes. Pass --live to error on missing live config. |
Onboarding
| Command | Description |
|---|---|
axon init | Interactive wizard — create keystore + recovery phrase |
axon init --guided | Wizard + interactive RPC / Hyperliquid / backend config |
axon import --mnemonic "<24-word>" | Recover keystore from BIP-39 phrase |
axon import --private-key <hex> | Recover from raw private key |
axon import --from-backup <file> | Restore from an encrypted backup file |
axon address | Print owner EOA + trading address |
axon token | Print env-var lines (AXON_URL, AXON_TOKEN) for agent runtimes |
Agent integration
| Command | Description |
|---|---|
axon install | Auto-configure MCP server in every detected runtime |
axon install <runtime> | Target a specific runtime (claude-code, cursor, cline, ...) |
axon install --print | Dry-run: show what would be written |
axon install --verify | Verify existing configs (catch stale paths) |
axon mcp | Run the MCP server over stdio (called by your agent runtime) |
axon mcp --list-tools | Print the tool schema as JSON and exit |
axon init-agent [dir] | Scaffold a runnable starter agent (JavaScript, zero config) |
axon skills install | Install the Axon SKILL.md into every detected agent runtime |
Trading + lifecycle
| Command | Description |
|---|---|
axon deposit | Open LI.FI / Jumper to bridge USDC to your Arbitrum owner EOA |
axon hl check | Hyperliquid preflight — verify owner funded, builder approved, agent key healthy |
axon hl deposit --amount <usd> | Bridge USDC into HL trading account via Bridge2 |
axon hl spot-to-perp --amount <usd> | Move USDC HL spot ↔ perp |
axon hl revoke-agent | Forget the persisted HL agent key (forces re-approval next trade) |
axon approve-builder | Sign Hyperliquid approveBuilderFee with the owner EOA (one-time setup) |
axon kill-switch on | Arm the kill switch (halts trading) |
axon kill-switch off | Disarm the kill switch |
axon settle | Trigger one settlement cycle immediately |
axon dashboard | Open the dashboard in your browser |
axon invite | Print your shareable invite/referrer code |
Strategies + marketplace
| Command | Description |
|---|---|
axon strategy init [dir] | Scaffold a new strategy project (TypeScript) |
axon strategy list | List installed strategies on the running daemon |
axon strategy install <id> | Install a strategy on the running daemon |
axon strategy uninstall <id> | Uninstall a strategy |
axon strategy assign <id> --wallet <id> | Bind a wallet to a strategy |
axon strategy backtest <manifest> | Replay a manifest against historical candles |
axon catalog list | List every strategy in the catalog (bundled + cached) |
axon catalog refresh | Force a catalog refresh now |
Audit log
| Command | Description |
|---|---|
axon audit verify | Recompute the hash chain and report tampering |
axon audit reset --confirm | Archive the audit log and start a fresh chain |
axon audit anchors | List recent local settlement markers |
axon audit rebuild-chain --confirm | Recover from a chain break (concurrent writers) |
axon audit prune --kind <name> --older-than <duration> --confirm | Drop spam rows of a given kind |
Telemetry + system
| Command | Description |
|---|---|
axon telemetry status | Print current anonymous-analytics consent state |
axon telemetry on | Enable anonymous usage analytics |
axon telemetry off | Disable anonymous usage analytics |
axon tutorial | Friendly in-terminal walkthrough |
Environment variables
| Variable | Default | What it does |
|---|---|---|
AXON_DATA_DIR | ~/.axon | Where the keystore, audit DB, configs live |
AXON_PORT | 47890 | Daemon HTTP port |
AXON_HOST | 127.0.0.1 | Daemon bind host (non-localhost requires escape hatch) |
AXON_ALLOW_NETWORK_EXPOSURE | unset | Set to 1 to allow non-localhost binding |
AXON_TELEMETRY | unset | Set to 0 to force-disable analytics |
AXON_CHAIN_ID | 42161 | Chain ID for live/testnet mode |
AXON_RPC_URL | Arbitrum public | RPC endpoint |
AXON_HL_URL | https://api.hyperliquid.xyz | Hyperliquid API base |
AXON_HL_BUILDER_ADDRESS | 0x0... | Platform builder address for HL builder fee |
AXON_HL_BUILDER_FEE_TENTHS_BPS | 30 | Builder fee in tenths of bps (30 = 3 bps; max 100 = 10 bps) |
AGENTTRADE_PASSPHRASE | unset | Legacy: pre-set the keystore unlock passphrase at boot |
The AGENTTRADE_* prefix is the legacy compatibility prefix — all canonical env vars use AXON_*.