[{"data":1,"prerenderedAt":610},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fv2\u002Fcli\u002Frun":3},{"id":4,"title":5,"body":6,"description":16,"extension":603,"meta":604,"navigation":605,"path":606,"seo":607,"stem":608,"__hash__":609},"docs\u002Fdocs\u002Fv2\u002Fcli\u002Frun.md","axon run",{"type":7,"value":8,"toc":595},"minimark",[9,13,17,93,101,104,109,119,162,168,172,175,199,259,268,278,299,306,310,317,348,421,427,431,437,463,470,474,485,496,500,572,575,591],[10,11,5],"h1",{"id":12},"axon-run",[14,15,16],"p",{},"One execution: an agent, an instruction, go. The agent boots, the instruction runs to\ncompletion, the agent exits. No TUI, no conversation.",[18,19,24],"pre",{"className":20,"code":21,"language":22,"meta":23,"style":23},"language-bash shiki shiki-themes dark-plus","axon run -a \u003Cagent> -p \u003Cprompt>              # a prompt the agent declares\naxon run -a \u003Cagent> --text \"\u003Cinstruction>\"   # a literal instruction\n","bash","",[25,26,27,69],"code",{"__ignoreMap":23},[28,29,32,36,40,44,48,51,54,57,59,62,65],"span",{"class":30,"line":31},"line",1,[28,33,35],{"class":34},"sCudf","axon",[28,37,39],{"class":38},"sKc5r"," run",[28,41,43],{"class":42},"scz_3"," -a",[28,45,47],{"class":46},"sTNBD"," \u003C",[28,49,50],{"class":38},"agen",[28,52,53],{"class":46},"t> ",[28,55,56],{"class":42},"-p",[28,58,47],{"class":46},[28,60,61],{"class":38},"promp",[28,63,64],{"class":46},"t>              ",[28,66,68],{"class":67},"sOLPB","# a prompt the agent declares\n",[28,70,72,74,76,78,80,82,84,87,90],{"class":30,"line":71},2,[28,73,35],{"class":34},[28,75,39],{"class":38},[28,77,43],{"class":42},[28,79,47],{"class":46},[28,81,50],{"class":38},[28,83,53],{"class":46},[28,85,86],{"class":42},"--text",[28,88,89],{"class":38}," \"\u003Cinstruction>\"",[28,91,92],{"class":67},"   # a literal instruction\n",[14,94,95,96,100],{},"Both arguments are named rather than inferred. An earlier version took only a prompt and\nresolved the agent from the working directory — fine for a human standing in a folder,\nwrong for everything else. Cron entries, git hooks, CI steps and Axon Fleet all know\n",[97,98,99],"em",{},"which"," agent they want and are not standing anywhere.",[14,102,103],{},"Naming both also makes an invocation quotable: the same line runs from a crontab, from an\nissue comment, or six months later.",[105,106,108],"h2",{"id":107},"the-agent","The agent",[14,110,111,114,115,118],{},[25,112,113],{},"-a"," (or ",[25,116,117],{},"--agent",") takes a path or a bare name:",[18,120,122],{"className":20,"code":121,"language":22,"meta":23,"style":23},"axon run -a .\u002Fagents\u002Fscout -p audit        # a path\naxon run -a barry.mk3 -p audit             # a name under your active profile\n",[25,123,124,144],{"__ignoreMap":23},[28,125,126,128,130,132,135,138,141],{"class":30,"line":31},[28,127,35],{"class":34},[28,129,39],{"class":38},[28,131,43],{"class":42},[28,133,134],{"class":38}," .\u002Fagents\u002Fscout",[28,136,137],{"class":42}," -p",[28,139,140],{"class":38}," audit",[28,142,143],{"class":67},"        # a path\n",[28,145,146,148,150,152,155,157,159],{"class":30,"line":71},[28,147,35],{"class":34},[28,149,39],{"class":38},[28,151,43],{"class":42},[28,153,154],{"class":38}," barry.mk3",[28,156,137],{"class":42},[28,158,140],{"class":38},[28,160,161],{"class":67},"             # a name under your active profile\n",[14,163,164,165,167],{},"A bare name resolves against the active profile only — it never searches other profiles.\nOmitting ",[25,166,113],{}," falls back to the working directory, which is the convenient form when you\nare already inside an agent.",[105,169,171],{"id":170},"the-instruction","The instruction",[14,173,174],{},"Two flags, deliberately distinct.",[14,176,177,186,187,190,191,194,195,198],{},[178,179,180,182,183],"strong",{},[25,181,56],{}," \u002F ",[25,184,185],{},"--prompt"," is a ",[97,188,189],{},"reference",". It is resolved and, for a ",[25,192,193],{},".vue"," prompt, rendered —\n",[25,196,197],{},"\u003Cscript setup>"," runs and any declared props are filled from the remaining flags.",[18,200,202],{"className":20,"code":201,"language":22,"meta":23,"style":23},"axon run -a barry.mk3 -p scout\naxon run -a barry.mk3 -p learn --domain tracing\naxon run -a barry.mk3 -p @cody\u002Feslint-scout:scout   # an installed prompt package\n",[25,203,204,219,240],{"__ignoreMap":23},[28,205,206,208,210,212,214,216],{"class":30,"line":31},[28,207,35],{"class":34},[28,209,39],{"class":38},[28,211,43],{"class":42},[28,213,154],{"class":38},[28,215,137],{"class":42},[28,217,218],{"class":38}," scout\n",[28,220,221,223,225,227,229,231,234,237],{"class":30,"line":71},[28,222,35],{"class":34},[28,224,39],{"class":38},[28,226,43],{"class":42},[28,228,154],{"class":38},[28,230,137],{"class":42},[28,232,233],{"class":38}," learn",[28,235,236],{"class":42}," --domain",[28,238,239],{"class":38}," tracing\n",[28,241,243,245,247,249,251,253,256],{"class":30,"line":242},3,[28,244,35],{"class":34},[28,246,39],{"class":38},[28,248,43],{"class":42},[28,250,154],{"class":38},[28,252,137],{"class":42},[28,254,255],{"class":38}," @cody\u002Feslint-scout:scout",[28,257,258],{"class":67},"   # an installed prompt package\n",[14,260,261,262,267],{},"Installed prompts are namespaced by their package, so they cannot shadow one you wrote.\nSee ",[263,264,266],"a",{"href":265},"\u002Fdocs\u002Fv2\u002Fagent\u002Fbuild\u002Fcapabilities","Capabilities",".",[14,269,270,186,274,277],{},[178,271,272],{},[25,273,86],{},[97,275,276],{},"literal",", used verbatim.",[18,279,281],{"className":20,"code":280,"language":22,"meta":23,"style":23},"axon run -a barry.mk3 --text \"Audit the org boundary and report what you find.\"\n",[25,282,283],{"__ignoreMap":23},[28,284,285,287,289,291,293,296],{"class":30,"line":31},[28,286,35],{"class":34},[28,288,39],{"class":38},[28,290,43],{"class":42},[28,292,154],{"class":38},[28,294,295],{"class":42}," --text",[28,297,298],{"class":38}," \"Audit the org boundary and report what you find.\"\n",[14,300,301,302,305],{},"They stay separate because collapsing them would mean guessing whether ",[25,303,304],{},"\"scout\""," is a\nprompt name or a one-word instruction — and the guess is wrong exactly when it matters.\nPassing both is an error.",[105,307,309],{"id":308},"arguments","Arguments",[14,311,312,313,316],{},"Any flag other than the ones above becomes a prompt argument, available inside a rendered\nprompt via ",[25,314,315],{},"defineProps\u003C{}>()",":",[18,318,320],{"className":20,"code":319,"language":22,"meta":23,"style":23},"axon run -a barry.mk3 -p learn --domain tracing --depth 3\n",[25,321,322],{"__ignoreMap":23},[28,323,324,326,328,330,332,334,336,338,341,344],{"class":30,"line":31},[28,325,35],{"class":34},[28,327,39],{"class":38},[28,329,43],{"class":42},[28,331,154],{"class":38},[28,333,137],{"class":42},[28,335,233],{"class":38},[28,337,236],{"class":42},[28,339,340],{"class":38}," tracing",[28,342,343],{"class":42}," --depth",[28,345,347],{"class":346},"sDGX8"," 3\n",[18,349,353],{"className":350,"code":351,"language":352,"meta":23,"style":23},"language-vue shiki shiki-themes dark-plus","\u003Cscript setup lang=\"ts\">\ndefineProps\u003C{ domain: string; depth?: string }>()\n\u003C\u002Fscript>\n","vue",[25,354,355,380,412],{"__ignoreMap":23},[28,356,357,361,364,368,371,374,377],{"class":30,"line":31},[28,358,360],{"class":359},"srRes","\u003C",[28,362,363],{"class":42},"script",[28,365,367],{"class":366},"s3F5K"," setup",[28,369,370],{"class":366}," lang",[28,372,373],{"class":46},"=",[28,375,376],{"class":38},"\"ts\"",[28,378,379],{"class":359},">\n",[28,381,382,385,388,391,394,398,401,404,407,409],{"class":30,"line":71},[28,383,384],{"class":34},"defineProps",[28,386,387],{"class":46},"\u003C{ ",[28,389,390],{"class":366},"domain",[28,392,393],{"class":46},": ",[28,395,397],{"class":396},"sNl3T","string",[28,399,400],{"class":46},"; ",[28,402,403],{"class":366},"depth",[28,405,406],{"class":46},"?: ",[28,408,397],{"class":396},[28,410,411],{"class":46}," }>()\n",[28,413,414,417,419],{"class":30,"line":242},[28,415,416],{"class":359},"\u003C\u002F",[28,418,363],{"class":42},[28,420,379],{"class":359},[14,422,423,424,426],{},"Arguments are ignored by ",[25,425,86],{},", which has nothing to render.",[105,428,430],{"id":429},"correlating-a-run-with-a-job","Correlating a run with a job",[14,432,433,436],{},[25,434,435],{},"--job"," tags the run with the job directory it belongs to:",[18,438,440],{"className":20,"code":439,"language":22,"meta":23,"style":23},"axon run -a barry.mk3 --text \"Propose the upgrade\" --job .repo\u002Fjobs\u002Fupdate-typescript\n",[25,441,442],{"__ignoreMap":23},[28,443,444,446,448,450,452,454,457,460],{"class":30,"line":31},[28,445,35],{"class":34},[28,447,39],{"class":38},[28,449,43],{"class":42},[28,451,154],{"class":38},[28,453,295],{"class":42},[28,455,456],{"class":38}," \"Propose the upgrade\"",[28,458,459],{"class":42}," --job",[28,461,462],{"class":38}," .repo\u002Fjobs\u002Fupdate-typescript\n",[14,464,465,466,469],{},"This is ",[178,467,468],{},"correlation only",". It does not change what is executed, load the job's brief, or\nwrite anything back — it records the association in the run's liveness record so a reader\n(Axon Fleet, another CLI invocation) can match a live agent to the work item it is\nanswering, rather than inferring it from timing.",[105,471,473],{"id":472},"output","Output",[14,475,476,477,480,481,484],{},"Agent text streams to stdout as it arrives, so a piped or CI caller sees progress.\nEverything else — tool calls, kernel telemetry, the full causal record — goes to the\nsession log under ",[25,478,479],{},"data\u002Fsessions\u002F",", where the console and ",[25,482,483],{},"axon logs"," read it.",[14,486,487,488,491,492,495],{},"If the instruction calls ",[25,489,490],{},"axon.ui.ask()",", it receives ",[25,493,494],{},"unavailable",": there is no connected\nhost to answer.",[105,497,499],{"id":498},"errors","Errors",[501,502,503,516],"table",{},[504,505,506],"thead",{},[507,508,509,513],"tr",{},[510,511,512],"th",{},"Error",[510,514,515],{},"Meaning",[517,518,519,536,552,562],"tbody",{},[507,520,521,527],{},[522,523,524],"td",{},[25,525,526],{},"RUN_INSTRUCTION_REQUIRED",[522,528,529,530,532,533,535],{},"Neither ",[25,531,56],{}," nor ",[25,534,86],{}," was given",[507,537,538,543],{},[522,539,540],{},[25,541,542],{},"RUN_INSTRUCTION_AMBIGUOUS",[522,544,545,546,548,549,551],{},"Both ",[25,547,56],{}," and ",[25,550,86],{}," were given",[507,553,554,559],{},[522,555,556],{},[25,557,558],{},"PROMPT_NOT_FOUND",[522,560,561],{},"The agent declares no prompt by that name; the available ones are listed",[507,563,564,569],{},[522,565,566],{},[25,567,568],{},"NOT_AN_AGENT",[522,570,571],{},"The resolved project is a module, bench or cognet",[573,574],"hr",{},[14,576,577,578,582,583,585,586,590],{},"See ",[263,579,581],{"href":580},"\u002Fdocs\u002Fv2\u002Fagent\u002Fsrc\u002Fprompts","prompts\u002F"," for authoring the instructions ",[25,584,56],{}," resolves,\nand ",[263,587,589],{"href":588},"\u002Fdocs\u002Fv2\u002Fagent\u002Fsrc\u002Fscripts","Scripts"," for automation that composes several\ninvocations.",[592,593,594],"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 .sTNBD, html code.shiki .sTNBD{--shiki-default:#D4D4D4}html pre.shiki code .sOLPB, html code.shiki .sOLPB{--shiki-default:#6A9955}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 .sDGX8, html code.shiki .sDGX8{--shiki-default:#B5CEA8}html pre.shiki code .srRes, html code.shiki .srRes{--shiki-default:#808080}html pre.shiki code .s3F5K, html code.shiki .s3F5K{--shiki-default:#9CDCFE}html pre.shiki code .sNl3T, html code.shiki .sNl3T{--shiki-default:#4EC9B0}",{"title":23,"searchDepth":71,"depth":71,"links":596},[597,598,599,600,601,602],{"id":107,"depth":71,"text":108},{"id":170,"depth":71,"text":171},{"id":308,"depth":71,"text":309},{"id":429,"depth":71,"text":430},{"id":472,"depth":71,"text":473},{"id":498,"depth":71,"text":499},"md",{},true,"\u002Fdocs\u002Fv2\u002Fcli\u002Frun",{"title":5,"description":16},"docs\u002Fv2\u002Fcli\u002Frun","Y1PHzX2lpAbhWNkE9I9Vh3CrKitX2Qd0PFb0RWhHldQ",1785671806801]