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

FlagDefaultDescription
--port3141WebSocket port to listen on

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.