Connecting to Your Agent

Once deployed, your agent is accessible three ways: the TUI, HTTP, and WebSocket.

TUI

Open Axon — your deployed agents appear alongside your local ones. Select one to connect.

axon

The TUI fetches your deployments automatically. Sessions, thread history, and the command palette all work identically against a deployed agent.

HTTP

Every route you defined in server/api/ is available at your agent's public URL. Authenticate with your API key.

# Chat — built-in route, available on every deployed agent
curl -X POST https://agents.axon.run/you/my-agent/api/chat \
  -H "Authorization: Bearer axon_..." \
  -H "Content-Type: application/json" \
  -d '{ "message": "summarise my open issues" }'

# Any custom route you defined
curl -X POST https://agents.axon.run/you/my-agent/api/scout \
  -H "Authorization: Bearer axon_..."

Routes that call axon.stream() return a streaming response. Consume it as Server-Sent Events or a chunked transfer.

WebSocket

For persistent connections and real-time streaming, connect directly to the thread WebSocket:

wscat -c wss://agents.axon.run/you/my-agent/thread \
  -H "Authorization: Bearer axon_..."

The thread protocol is the same protocol the TUI uses. Send messages, receive streamed entries as they are produced.

Finding your URL and key

axon agent status   # prints URL and key summary for the current agent

Both are also printed on first deploy and available in the dashboard.