[{"data":1,"prerenderedAt":286},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fv2\u002Fcli\u002Fdev":3},{"id":4,"title":5,"body":6,"description":16,"extension":280,"meta":281,"navigation":95,"path":282,"seo":283,"stem":284,"__hash__":285},"docs\u002Fdocs\u002Fv2\u002Fcli\u002Fdev.md","axon dev",{"type":7,"value":8,"toc":274},"minimark",[9,13,17,56,59,64,184,187,191,229,233,248,257,261,270],[10,11,5],"h1",{"id":12},"axon-dev",[14,15,16],"p",{},"Boot the agent locally with hot reload.",[18,19,24],"pre",{"className":20,"code":21,"language":22,"meta":23,"style":23},"language-bash shiki shiki-themes dark-plus","axon dev\naxon dev --port 3141\n","bash","",[25,26,27,40],"code",{"__ignoreMap":23},[28,29,32,36],"span",{"class":30,"line":31},"line",1,[28,33,35],{"class":34},"sCudf","axon",[28,37,39],{"class":38},"sKc5r"," dev\n",[28,41,43,45,48,52],{"class":30,"line":42},2,[28,44,35],{"class":34},[28,46,47],{"class":38}," dev",[28,49,51],{"class":50},"scz_3"," --port",[28,53,55],{"class":54},"sDGX8"," 3141\n",[14,57,58],{},"Run from your agent directory. Axon prepares the manifest, boots the agent, and prints\nthe WebSocket URL. Source changes hot-reload into the running session when Axon can\npreserve the runtime boundary safely.",[60,61,63],"h2",{"id":62},"output","Output",[18,65,67],{"className":20,"code":66,"language":22,"meta":23,"style":23},"✓ prepare 12ms\n✓ boot 340ms\n\nmy-agent\n  ├─ routes (2)\n  │   ├─ POST \u002Fapi\u002Fchat\n  │   └─ POST \u002Fapi\u002Fscout\n  ├─ tools (5)\n  └─ scripts (3)\n\n➜ Runtime: ws:\u002F\u002Flocalhost:3141\u002Fws\n",[25,68,69,80,90,97,103,116,131,144,155,167,172],{"__ignoreMap":23},[28,70,71,74,77],{"class":30,"line":31},[28,72,73],{"class":34},"✓",[28,75,76],{"class":38}," prepare",[28,78,79],{"class":38}," 12ms\n",[28,81,82,84,87],{"class":30,"line":42},[28,83,73],{"class":34},[28,85,86],{"class":38}," boot",[28,88,89],{"class":38}," 340ms\n",[28,91,93],{"class":30,"line":92},3,[28,94,96],{"emptyLinePlaceholder":95},true,"\n",[28,98,100],{"class":30,"line":99},4,[28,101,102],{"class":34},"my-agent\n",[28,104,106,109,112],{"class":30,"line":105},5,[28,107,108],{"class":34},"  ├─",[28,110,111],{"class":38}," routes",[28,113,115],{"class":114},"sTNBD"," (2)\n",[28,117,119,122,125,128],{"class":30,"line":118},6,[28,120,121],{"class":34},"  │",[28,123,124],{"class":38},"   ├─",[28,126,127],{"class":38}," POST",[28,129,130],{"class":38}," \u002Fapi\u002Fchat\n",[28,132,134,136,139,141],{"class":30,"line":133},7,[28,135,121],{"class":34},[28,137,138],{"class":38},"   └─",[28,140,127],{"class":38},[28,142,143],{"class":38}," \u002Fapi\u002Fscout\n",[28,145,147,149,152],{"class":30,"line":146},8,[28,148,108],{"class":34},[28,150,151],{"class":38}," tools",[28,153,154],{"class":114}," (5)\n",[28,156,158,161,164],{"class":30,"line":157},9,[28,159,160],{"class":34},"  └─",[28,162,163],{"class":38}," scripts",[28,165,166],{"class":114}," (3)\n",[28,168,170],{"class":30,"line":169},10,[28,171,96],{"emptyLinePlaceholder":95},[28,173,175,178,181],{"class":30,"line":174},11,[28,176,177],{"class":34},"➜",[28,179,180],{"class":38}," Runtime:",[28,182,183],{"class":38}," ws:\u002F\u002Flocalhost:3141\u002Fws\n",[14,185,186],{},"The manifest tree shows everything the agent registered at boot — routes, tools, and\nscripts. If something is missing, it didn't load.",[60,188,190],{"id":189},"options","Options",[192,193,194,210],"table",{},[195,196,197],"thead",{},[198,199,200,204,207],"tr",{},[201,202,203],"th",{},"Flag",[201,205,206],{},"Default",[201,208,209],{},"Description",[211,212,213],"tbody",{},[198,214,215,221,226],{},[216,217,218],"td",{},[25,219,220],{},"--port",[216,222,223],{},[25,224,225],{},"3141",[216,227,228],{},"WebSocket port to listen on",[60,230,232],{"id":231},"hot-reload","Hot reload",[14,234,235,236,239,240,243,244,247],{},"Watches ",[25,237,238],{},"src\u002F",", ",[25,241,242],{},".env",", and ",[25,245,246],{},"package.json",". Tools, prompts, scripts, boot context, and\nenvironment changes reload into the running agent for future turns. Runtime boundary\nchanges, such as server routes or config, require a restart.",[14,249,250,251,256],{},"For the full reload model, see ",[252,253,255],"a",{"href":254},"\u002Fdocs\u002Fv2\u002Fconcepts\u002Fhot-reload","Hot Reload",".",[60,258,260],{"id":259},"shutdown","Shutdown",[14,262,263,266,267,269],{},[25,264,265],{},"Ctrl+C"," once for graceful shutdown. ",[25,268,265],{}," twice to force exit.",[271,272,273],"style",{},"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 pre.shiki code .scz_3, html code.shiki .scz_3{--shiki-default:#569CD6}html pre.shiki code .sDGX8, html code.shiki .sDGX8{--shiki-default:#B5CEA8}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 .sTNBD, html code.shiki .sTNBD{--shiki-default:#D4D4D4}",{"title":23,"searchDepth":42,"depth":42,"links":275},[276,277,278,279],{"id":62,"depth":42,"text":63},{"id":189,"depth":42,"text":190},{"id":231,"depth":42,"text":232},{"id":259,"depth":42,"text":260},"md",{},"\u002Fdocs\u002Fv2\u002Fcli\u002Fdev",{"title":5,"description":16},"docs\u002Fv2\u002Fcli\u002Fdev","RIisUG2av2tTL7bL1r3Ny0aLbBIcE12NjXpZu1OZoS0",1785671806718]