[{"data":1,"prerenderedAt":197},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fv2\u002Ftui\u002Fconnecting":3},{"id":4,"title":5,"body":6,"description":17,"extension":190,"meta":191,"navigation":192,"path":193,"seo":194,"stem":195,"__hash__":196},"docs\u002Fdocs\u002Fv2\u002Ftui\u002Fconnecting.md","Connecting",{"type":7,"value":8,"toc":181},"minimark",[9,14,18,23,26,62,65,70,74,81,88,92,95,102,106,113,117,120,124,130,133,137,140,163,166,170,173,177],[10,11,13],"h1",{"id":12},"connecting-to-agents","Connecting to agents",[15,16,17],"p",{},"The TUI connects to agents running anywhere — locally on your machine, deployed to Axon\nCloud, or on any server running the Axon runtime. Switch between them at any time without\nleaving the session.",[19,20,22],"h2",{"id":21},"local-agents","Local agents",[15,24,25],{},"Local agents are agents you've built that run on your machine. When you select one, the\nTUI spawns the agent process in the background and connects to it. The capsule starts,\ntools load, and the agent is ready.",[27,28,33],"pre",{"className":29,"code":30,"language":31,"meta":32,"style":32},"language-bash shiki shiki-themes dark-plus","# Boot Axon from your agent directory\ncd ~\u002Fmy-agent\naxon\n","bash","",[34,35,36,45,56],"code",{"__ignoreMap":32},[37,38,41],"span",{"class":39,"line":40},"line",1,[37,42,44],{"class":43},"sOLPB","# Boot Axon from your agent directory\n",[37,46,48,52],{"class":39,"line":47},2,[37,49,51],{"class":50},"sCudf","cd",[37,53,55],{"class":54},"sKc5r"," ~\u002Fmy-agent\n",[37,57,59],{"class":39,"line":58},3,[37,60,61],{"class":50},"axon\n",[15,63,64],{},"The TUI detects the agent from the working directory and connects automatically.",[66,67],"terminal-image",{"alt":68,"src":69},"TUI showing a connected agent ready for input with tool count and thread ID visible in the header","\u002Ftui\u002Femptyaxonconnectedtogpt55ready.webp",[19,71,73],{"id":72},"repo-agents","Repo agents",[15,75,76,77,80],{},"If your repository has a ",[34,78,79],{},".agents\u002F"," folder, those agents appear automatically in the\nagent switcher. No configuration required — the TUI scans the repo on boot and lists them\nalongside your owned agents.",[15,82,83,84,87],{},"Repo agents are read-only in the switcher. To edit one, open it directly with\n",[34,85,86],{},":agent open",".",[19,89,91],{"id":90},"deployed-cloud-agents","Deployed cloud agents",[15,93,94],{},"Agents deployed to Axon Cloud appear in the agents tab with their deployment status. The\nTUI connects over WebSocket with automatic JWT auth — no API keys to manage manually.",[15,96,97,98,101],{},"Select a deployed agent and the TUI handles the connection. If the agent is provisioning\nit will show its status. If it's stopped, start it first with ",[34,99,100],{},":agent deploy"," or from\nthe dashboard.",[19,103,105],{"id":104},"profiles","Profiles",[15,107,108,109,112],{},"The TUI supports multiple profiles — each profile is a separate account with its own\nagents, sessions, and settings. Switch profiles at login or via ",[34,110,111],{},":logout"," to sign in as\na different user.",[66,114],{"alt":115,"src":116},"TUI profile selection screen showing multiple user profiles to choose from on login","\u002Ftui\u002Faxontuiprofileselectionscreen.webp",[15,118,119],{},"Each profile has its own set of agents. Switching profiles gives you a completely\nseparate workspace.",[19,121,123],{"id":122},"switching-agents","Switching agents",[15,125,126,129],{},[34,127,128],{},"*"," opens the agent and model switcher at any time. The agents tab shows everything\navailable within the current profile — owned, repo, and deployed — with the active agent\nmarked.",[15,131,132],{},"Switching agents starts a new session with that agent. Your previous session is preserved\n— switch back and it resumes.",[19,134,136],{"id":135},"arbitrary-axon-servers","Arbitrary Axon servers",[15,138,139],{},"Any server running the Axon runtime can be connected to directly — self-hosted agents,\nstaging environments, or team-shared instances.",[27,141,143],{"className":29,"code":142,"language":31,"meta":32,"style":32},"axon connect wss:\u002F\u002Fmy-agent.example.com --key axon_...\n",[34,144,145],{"__ignoreMap":32},[37,146,147,150,153,156,160],{"class":39,"line":40},[37,148,149],{"class":50},"axon",[37,151,152],{"class":54}," connect",[37,154,155],{"class":54}," wss:\u002F\u002Fmy-agent.example.com",[37,157,159],{"class":158},"scz_3"," --key",[37,161,162],{"class":54}," axon_...\n",[15,164,165],{},"The connection is authenticated with the API key issued by that server. Once connected,\nthe session behaves identically to any other agent — same palette, same pages, same\nkeyboard shortcuts.",[19,167,169],{"id":168},"authentication","Authentication",[15,171,172],{},"On first boot, or when logging into a new profile, Axon uses a device authorization flow.\nA code is displayed in the TUI — open the link, enter the code, and the session\nauthenticates without typing credentials into the terminal.",[66,174],{"alt":175,"src":176},"TUI showing the device authorization flow with a code and URL to complete authentication in the browser","\u002Ftui\u002Faxontuiawaitingdeviceaprovalstate.webp",[178,179,180],"style",{},"html pre.shiki code .sOLPB, html code.shiki .sOLPB{--shiki-default:#6A9955}html pre.shiki code .sCudf, html code.shiki .sCudf{--shiki-default:#DCDCAA}html pre.shiki code .sKc5r, html code.shiki .sKc5r{--shiki-default:#CE9178}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .scz_3, html code.shiki .scz_3{--shiki-default:#569CD6}",{"title":32,"searchDepth":47,"depth":47,"links":182},[183,184,185,186,187,188,189],{"id":21,"depth":47,"text":22},{"id":72,"depth":47,"text":73},{"id":90,"depth":47,"text":91},{"id":104,"depth":47,"text":105},{"id":122,"depth":47,"text":123},{"id":135,"depth":47,"text":136},{"id":168,"depth":47,"text":169},"md",{},true,"\u002Fdocs\u002Fv2\u002Ftui\u002Fconnecting",{"title":5,"description":17},"docs\u002Fv2\u002Ftui\u002Fconnecting","95nW5VSTupA_co35yLZ68_e9cffFFefoo2KR3_ZLCIo",1785671804876]