[{"data":1,"prerenderedAt":430},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fv2\u002Fworkspace\u002Fagents":3},{"id":4,"title":5,"body":6,"description":422,"extension":423,"meta":424,"navigation":425,"path":426,"seo":427,"stem":428,"__hash__":429},"docs\u002Fdocs\u002Fv2\u002Fworkspace\u002Fagents.md","agents\u002F",{"type":7,"value":8,"toc":416},"minimark",[9,13,22,201,206,225,232,236,251,283,286,301,305,340,354,358,370,389,403,412],[10,11,5],"h1",{"id":12},"agents",[14,15,16,17,21],"p",{},"All agents live at ",[18,19,20],"code",{},"~\u002F.axon\u002Fagents\u002F",". Each subfolder is a self-contained agent — a standard Bun TypeScript project with the structure Axon knows how to read.",[23,24,29],"pre",{"className":25,"code":26,"language":27,"meta":28,"style":28},"language-bash shiki shiki-themes dark-plus","~\u002F.axon\u002Fagents\u002F\n├── default\u002F\n│   ├── data\u002F\n│   ├── modules\u002F\n│   ├── server\u002F\n│   ├── src\u002F\n│   │   ├── prompts\u002F\n│   │   ├── scripts\u002F\n│   │   ├── tools\u002F\n│   │   └── boot.vue\n│   ├── .env\n│   ├── axon.config.ts\n│   ├── package.json\n│   └── tsconfig.json\n└── my-agent\u002F\n    └── ...\n","bash","",[18,30,31,40,51,63,73,83,93,106,118,130,143,153,163,173,183,192],{"__ignoreMap":28},[32,33,36],"span",{"class":34,"line":35},"line",1,[32,37,39],{"class":38},"sTNBD","~\u002F.axon\u002Fagents\u002F\n",[32,41,43,47],{"class":34,"line":42},2,[32,44,46],{"class":45},"sCudf","├──",[32,48,50],{"class":49},"sKc5r"," default\u002F\n",[32,52,54,57,60],{"class":34,"line":53},3,[32,55,56],{"class":45},"│",[32,58,59],{"class":49},"   ├──",[32,61,62],{"class":49}," data\u002F\n",[32,64,66,68,70],{"class":34,"line":65},4,[32,67,56],{"class":45},[32,69,59],{"class":49},[32,71,72],{"class":49}," modules\u002F\n",[32,74,76,78,80],{"class":34,"line":75},5,[32,77,56],{"class":45},[32,79,59],{"class":49},[32,81,82],{"class":49}," server\u002F\n",[32,84,86,88,90],{"class":34,"line":85},6,[32,87,56],{"class":45},[32,89,59],{"class":49},[32,91,92],{"class":49}," src\u002F\n",[32,94,96,98,101,103],{"class":34,"line":95},7,[32,97,56],{"class":45},[32,99,100],{"class":49},"   │",[32,102,59],{"class":49},[32,104,105],{"class":49}," prompts\u002F\n",[32,107,109,111,113,115],{"class":34,"line":108},8,[32,110,56],{"class":45},[32,112,100],{"class":49},[32,114,59],{"class":49},[32,116,117],{"class":49}," scripts\u002F\n",[32,119,121,123,125,127],{"class":34,"line":120},9,[32,122,56],{"class":45},[32,124,100],{"class":49},[32,126,59],{"class":49},[32,128,129],{"class":49}," tools\u002F\n",[32,131,133,135,137,140],{"class":34,"line":132},10,[32,134,56],{"class":45},[32,136,100],{"class":49},[32,138,139],{"class":49},"   └──",[32,141,142],{"class":49}," boot.vue\n",[32,144,146,148,150],{"class":34,"line":145},11,[32,147,56],{"class":45},[32,149,59],{"class":49},[32,151,152],{"class":49}," .env\n",[32,154,156,158,160],{"class":34,"line":155},12,[32,157,56],{"class":45},[32,159,59],{"class":49},[32,161,162],{"class":49}," axon.config.ts\n",[32,164,166,168,170],{"class":34,"line":165},13,[32,167,56],{"class":45},[32,169,59],{"class":49},[32,171,172],{"class":49}," package.json\n",[32,174,176,178,180],{"class":34,"line":175},14,[32,177,56],{"class":45},[32,179,139],{"class":49},[32,181,182],{"class":49}," tsconfig.json\n",[32,184,186,189],{"class":34,"line":185},15,[32,187,188],{"class":45},"└──",[32,190,191],{"class":49}," my-agent\u002F\n",[32,193,195,198],{"class":34,"line":194},16,[32,196,197],{"class":45},"    └──",[32,199,200],{"class":49}," ...\n",[202,203,205],"h2",{"id":204},"the-default-agent","The default agent",[14,207,208,209,212,213,216,217,220,221,224],{},"Axon ships with an agent pre-populated at ",[18,210,211],{},"agents\u002Fdefault\u002F",". Running ",[18,214,215],{},"axon"," opens it. It has ",[18,218,219],{},"@axon\u002Ffs"," and ",[18,222,223],{},"@axon\u002Ffetch"," pre-installed and sensible env passthrough for development use.",[14,226,227,228,231],{},"It is a regular agent. The name ",[18,229,230],{},"default"," is just the folder name — nothing in the runtime treats it specially. Edit it, install modules into it, or ignore it entirely and create your own.",[202,233,235],{"id":234},"creating-an-agent","Creating an agent",[23,237,239],{"className":25,"code":238,"language":27,"meta":28,"style":28},"axon init my-agent\n",[18,240,241],{"__ignoreMap":28},[32,242,243,245,248],{"class":34,"line":35},[32,244,215],{"class":45},[32,246,247],{"class":49}," init",[32,249,250],{"class":49}," my-agent\n",[14,252,253,254,257,258,261,262,261,265,261,268,271,272,261,275,278,279,282],{},"Scaffolds ",[18,255,256],{},"~\u002F.axon\u002Fagents\u002Fmy-agent\u002F"," with ",[18,259,260],{},"axon.config.ts",", ",[18,263,264],{},".env",[18,266,267],{},"package.json",[18,269,270],{},"tsconfig.json",", and empty ",[18,273,274],{},"src\u002F",[18,276,277],{},"server\u002F",", and ",[18,280,281],{},"data\u002F"," directories. No tools pre-installed.",[14,284,285],{},"Open it with:",[23,287,289],{"className":25,"code":288,"language":27,"meta":28,"style":28},"axon --agent my-agent\n",[18,290,291],{"__ignoreMap":28},[32,292,293,295,299],{"class":34,"line":35},[32,294,215],{"class":45},[32,296,298],{"class":297},"scz_3"," --agent",[32,300,250],{"class":49},[202,302,304],{"id":303},"installing-modules-into-an-agent","Installing modules into an agent",[23,306,308],{"className":25,"code":307,"language":27,"meta":28,"style":28},"axon install @axon\u002Fgithub              # install into the active agent\naxon install @axon\u002Fgithub --agent my-agent  # install into a specific agent\n",[18,309,310,324],{"__ignoreMap":28},[32,311,312,314,317,320],{"class":34,"line":35},[32,313,215],{"class":45},[32,315,316],{"class":49}," install",[32,318,319],{"class":49}," @axon\u002Fgithub",[32,321,323],{"class":322},"sOLPB","              # install into the active agent\n",[32,325,326,328,330,332,334,337],{"class":34,"line":42},[32,327,215],{"class":45},[32,329,316],{"class":49},[32,331,319],{"class":49},[32,333,298],{"class":297},[32,335,336],{"class":49}," my-agent",[32,338,339],{"class":322},"  # install into a specific agent\n",[14,341,342,343,346,347,349,350,353],{},"Installing copies module source into ",[18,344,345],{},"modules\u002F",", merges npm dependencies into ",[18,348,267],{},", and runs ",[18,351,352],{},"bun install",". Nested module dependencies are resolved automatically.",[202,355,357],{"id":356},"publishing-an-agent-to-the-registry","Publishing an agent to the registry",[23,359,361],{"className":25,"code":360,"language":27,"meta":28,"style":28},"axon publish\n",[18,362,363],{"__ignoreMap":28},[32,364,365,367],{"class":34,"line":35},[32,366,215],{"class":45},[32,368,369],{"class":49}," publish\n",[14,371,372,373,261,375,261,377,278,379,382,383,261,385,388],{},"Packages ",[18,374,260],{},[18,376,274],{},[18,378,267],{},[18,380,381],{},"axon.manifest.json"," and uploads to the registry. Excludes ",[18,384,264],{},[18,386,387],{},"node_modules\u002F",", and generated files.",[14,390,391,392,395,396,399,400,402],{},"Someone who installs a published agent gets a complete folder. They open it with ",[18,393,394],{},"axon --agent \u003Cname>"," and add the env keys declared in ",[18,397,398],{},"env.needs"," to their ",[18,401,264],{},".",[14,404,405,406,411],{},"See ",[407,408,410],"a",{"href":409},"\u002Fdocs\u002Fv2\u002Fagents\u002Fpublishing","Publishing agents"," for what is included and excluded.",[413,414,415],"style",{},"html pre.shiki code .sTNBD, html code.shiki .sTNBD{--shiki-default:#D4D4D4}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}html pre.shiki code .sOLPB, html code.shiki .sOLPB{--shiki-default:#6A9955}",{"title":28,"searchDepth":42,"depth":42,"links":417},[418,419,420,421],{"id":204,"depth":42,"text":205},{"id":234,"depth":42,"text":235},{"id":303,"depth":42,"text":304},{"id":356,"depth":42,"text":357},"All agents live at ~\u002F.axon\u002Fagents\u002F. Each subfolder is a self-contained agent — a standard Bun TypeScript project with the structure Axon knows how to read.","md",{},true,"\u002Fdocs\u002Fv2\u002Fworkspace\u002Fagents",{"title":5,"description":422},"docs\u002Fv2\u002Fworkspace\u002Fagents","Nd6utP3jR1phDKIWSDI2UrKwh0hz6VQluQab_Zq4yBA",1785671804879]