Axis Overview
Axis is the Eternum onchain agent CLI. It discovers active worlds, authenticates with Cartridge Controller, and runs an LLM-driven tick loop that observes game state and executes on-chain actions.
What Axis Does
- Discovers live worlds across
slot,sepolia, andmainnet - Authenticates via password (headless) or browser (interactive)
- Runs in TUI mode or headless server mode
- Generates game actions from contract ABIs at runtime
- Persists agent memory and strategy per world
- Exposes HTTP + stdin control in headless mode
Get Started
curl -fsSL https://github.com/bibliothecadao/eternum/releases/latest/download/install-axis.sh | bash
echo "ANTHROPIC_API_KEY=sk-ant-..." >> ~/.eternum-agent/.env
axisTUI vs Headless
TUI (axis) | Headless (axis run --headless) | |
|---|---|---|
| Use when | Running manually on a laptop | VPS, CI, fleet orchestration |
| World selection | Interactive picker | --world=<name> (required) |
| Auth | Opens browser automatically | --method=password or QR + redirect |
| Output | Terminal UI with chat log | NDJSON to stdout |
| Control | Keyboard input | HTTP API, stdin, SSE |