axon dev
Boot the agent locally with hot reload.
axon dev
axon dev --port 3141
Run from your agent directory. Axon prepares the manifest, boots the agent, and prints the WebSocket URL. Source changes hot-reload into the running session when Axon can preserve the runtime boundary safely.
Options
| Flag | Default | Description |
|---|---|---|
--port | 3141 | Port to serve the agent on |
--expose | off | Serve on every network interface, not only this machine |
The agent is served on localhost only. A locally run agent's surface has no credential
check — that is what a deployment adds — so --expose puts it in reach of anything on your
network. Use it when you mean to, such as testing from a phone on the same Wi-Fi.
Hot reload
Watches src/, .env, and package.json. Tools, prompts, scripts, boot context, and
environment changes reload into the running agent for future turns. Runtime boundary
changes, such as server routes or config, require a restart.
For the full reload model, see Hot Reload.
Shutdown
Ctrl+C once for graceful shutdown. Ctrl+C twice to force exit.