[{"data":1,"prerenderedAt":923},["ShallowReactive",2],{"footer-links":3,"content-\u002Fusage":12},[4,9],{"path":5,"title":6,"type":7,"isExternal":8},"https:\u002F\u002Fgithub.com\u002Fahumandev\u002Fautocode","GitHub","link",true,{"path":10,"title":11,"type":7,"isExternal":8},"https:\u002F\u002Fwww.npmjs.com\u002F@ahumandev\u002Fautocode","NPM",{"id":13,"title":14,"body":15,"description":25,"extension":918,"meta":919,"navigation":8,"path":920,"seo":921,"stem":21,"__hash__":922},"content\u002Fusage.md","Usage",{"type":16,"value":17,"toc":906},"minimark",[18,22,26,31,92,96,161,218,222,225,332,336,398,402,474,478,651,655,684,756,760,763,805,809,812,837,843,880,885,902],[19,20,14],"h1",{"id":21},"usage",[23,24,25],"p",{},"AutoCode is used from inside OpenCode after the plugin is loaded. It is not a standalone application and does not start a web server or expose a local URL. It registers managed agents, slash commands, generated skills, and tools.",[27,28,30],"h3",{"id":29},"primary-agents","Primary Agents",[32,33,34,47],"table",{},[35,36,37],"thead",{},[38,39,40,44],"tr",{},[41,42,43],"th",{},"Agent",[41,45,46],{},"Purpose",[48,49,50,62,72,82],"tbody",{},[38,51,52,59],{},[53,54,55],"td",{},[56,57,58],"code",{},"research",[53,60,61],{},"Gathers evidence and produces Research Reports.",[38,63,64,69],{},[53,65,66],{},[56,67,68],{},"design",[53,70,71],{},"Creates solution plans from conversation and optional Research Report data.",[38,73,74,79],{},[53,75,76],{},[56,77,78],{},"auto",[53,80,81],{},"Autonomously executes drafted jobs from solution plans.",[38,83,84,89],{},[53,85,86],{},[56,87,88],{},"assist",[53,90,91],{},"Interactively executes immediate tasks with human control, optionally using solution plans as guidance.",[27,93,95],{"id":94},"typical-job-workflow","Typical job workflow",[97,98,103],"pre",{"className":99,"code":100,"language":101,"meta":102,"style":102},"language-mermaid shiki shiki-themes github-light github-dark","flowchart TD\n  Concepts[.agents\u002Fjobs\u002Fconcepts] --> Drafts[.agents\u002Fjobs\u002Fdrafts]\n  Drafts --> Assist[.agents\u002Fjobs\u002Fassist]\n  Drafts --> Executing[.agents\u002Fjobs\u002Fexecuting]\n  Executing --> Review[.agents\u002Fjobs\u002Freview]\n  Executing -.blocked.-> Facilitate[.agents\u002Fjobs\u002Ffacilitate]\n  Facilitate -.unblocked.-> Executing\n  Assist --> Shelved[.agents\u002Fjobs\u002Fshelved]\n  Review --> Shelved[.agents\u002Fjobs\u002Fshelved]\n","mermaid","",[56,104,105,113,119,125,131,137,143,149,155],{"__ignoreMap":102},[106,107,110],"span",{"class":108,"line":109},"line",1,[106,111,112],{},"flowchart TD\n",[106,114,116],{"class":108,"line":115},2,[106,117,118],{},"  Concepts[.agents\u002Fjobs\u002Fconcepts] --> Drafts[.agents\u002Fjobs\u002Fdrafts]\n",[106,120,122],{"class":108,"line":121},3,[106,123,124],{},"  Drafts --> Assist[.agents\u002Fjobs\u002Fassist]\n",[106,126,128],{"class":108,"line":127},4,[106,129,130],{},"  Drafts --> Executing[.agents\u002Fjobs\u002Fexecuting]\n",[106,132,134],{"class":108,"line":133},5,[106,135,136],{},"  Executing --> Review[.agents\u002Fjobs\u002Freview]\n",[106,138,140],{"class":108,"line":139},6,[106,141,142],{},"  Executing -.blocked.-> Facilitate[.agents\u002Fjobs\u002Ffacilitate]\n",[106,144,146],{"class":108,"line":145},7,[106,147,148],{},"  Facilitate -.unblocked.-> Executing\n",[106,150,152],{"class":108,"line":151},8,[106,153,154],{},"  Assist --> Shelved[.agents\u002Fjobs\u002Fshelved]\n",[106,156,158],{"class":108,"line":157},9,[106,159,160],{},"  Review --> Shelved[.agents\u002Fjobs\u002Fshelved]\n",[162,163,164,172,179,188,198,204],"ol",{},[165,166,167,168,171],"li",{},"Create or select a concept in ",[56,169,170],{},".agents\u002Fjobs\u002Fconcepts",".",[165,173,174,175,178],{},"Run ",[56,176,177],{},"\u002Fjob-design"," to create a solution plan from the selected concept or current planning context.",[165,180,174,181,184,185,171],{},[56,182,183],{},"\u002Fjob-draft"," to save the plan in ",[56,186,187],{},".agents\u002Fjobs\u002Fdrafts\u002F{job_name}\u002Fplan.md",[165,189,174,190,193,194,197],{},[56,191,192],{},"\u002Fjob-execute-assist"," to execute with human steering, or ",[56,195,196],{},"\u002Fjob-execute-auto"," to execute autonomously.",[165,199,200,201,171],{},"Review the completed work from ",[56,202,203],{},".agents\u002Fjobs\u002Freview",[165,205,174,206,209,210,213,214,217],{},[56,207,208],{},"\u002Fjob-review-commit"," to accept (git commit) and shelve (clean up files) the job, or ",[56,211,212],{},"\u002Fjob-shelve"," (alias ",[56,215,216],{},"\u002Fshelve",") to close it without acceptance.",[27,219,221],{"id":220},"workflow-commands","Workflow commands",[23,223,224],{},"Normal prompts can start or resume work. Slash commands are convenience wrappers around the same lifecycle.",[32,226,227,236],{},[35,228,229],{},[38,230,231,234],{},[41,232,233],{},"Command",[41,235,46],{},[48,237,238,251,260,271,286,299,311,320],{},[38,239,240,245],{},[53,241,242],{},[56,243,244],{},"\u002Fjob-concepts",[53,246,247,248,171],{},"Saves concept Markdown files in ",[56,249,250],{},".agents\u002Fjobs\u002Fconcepts\u002F",[38,252,253,257],{},[53,254,255],{},[56,256,177],{},[53,258,259],{},"Designs a solution plan from a selected concept or current planning context.",[38,261,262,266],{},[53,263,264],{},[56,265,183],{},[53,267,268,269,171],{},"Saves a solution plan as a draft in ",[56,270,187],{},[38,272,273,278],{},[53,274,275],{},[56,276,277],{},"\u002Fjob-execute",[53,279,280,281,283,284,171],{},"Selects and executes a job in the current session with either ",[56,282,78],{}," or ",[56,285,88],{},[38,287,288,292],{},[53,289,290],{},[56,291,192],{},[53,293,294,295,298],{},"Moves an approved draft to ",[56,296,297],{},".agents\u002Fjobs\u002Fassist\u002F{job_name}\u002F"," and starts an assist session.",[38,300,301,305],{},[53,302,303],{},[56,304,196],{},[53,306,294,307,310],{},[56,308,309],{},".agents\u002Fjobs\u002Fexecuting\u002F{job_name}\u002F"," and starts an auto session.",[38,312,313,317],{},[53,314,315],{},[56,316,208],{},[53,318,319],{},"Accepts reviewed work, commits when applicable, and shelves the job.",[38,321,322,326],{},[53,323,324],{},[56,325,212],{},[53,327,328,329,171],{},"Moves the current or selected job to ",[56,330,331],{},".agents\u002Fjobs\u002Fshelved\u002F{job_name}\u002F",[27,333,335],{"id":334},"handover-commands","Handover commands",[32,337,338,346],{},[35,339,340],{},[38,341,342,344],{},[41,343,233],{},[41,345,46],{},[48,347,348,358,368,378,388],{},[38,349,350,355],{},[53,351,352],{},[56,353,354],{},"\u002Fnew-research",[53,356,357],{},"Creates a new research session from recent context.",[38,359,360,365],{},[53,361,362],{},[56,363,364],{},"\u002Fnew-design",[53,366,367],{},"Creates a new design session for a solution plan.",[38,369,370,375],{},[53,371,372],{},[56,373,374],{},"\u002Fnew-assist",[53,376,377],{},"Creates a new assist session for interactive implementation.",[38,379,380,385],{},[53,381,382],{},[56,383,384],{},"\u002Fnew-auto",[53,386,387],{},"Creates a new auto session for autonomous implementation.",[38,389,390,395],{},[53,391,392],{},[56,393,394],{},"\u002Fnew-troubleshoot",[53,396,397],{},"Creates a new troubleshooting session from recent symptoms and evidence.",[27,399,401],{"id":400},"documentation-commands","Documentation commands",[32,403,404,412],{},[35,405,406],{},[38,407,408,410],{},[41,409,233],{},[41,411,46],{},[48,413,414,424,434,444,454,464],{},[38,415,416,421],{},[53,417,418],{},[56,419,420],{},"\u002Fdocs",[53,422,423],{},"Document all recent changes.",[38,425,426,431],{},[53,427,428],{},[56,429,430],{},"\u002Fdocs-code",[53,432,433],{},"Documents recent technical architecture and code design decisions.",[38,435,436,441],{},[53,437,438],{},[56,439,440],{},"\u002Fdocs-conventions",[53,442,443],{},"Documents recent naming conventions and project terminology.",[38,445,446,451],{},[53,447,448],{},[56,449,450],{},"\u002Fdocs-prd",[53,452,453],{},"Documents recently updated product requirements and user roles.",[38,455,456,461],{},[53,457,458],{},[56,459,460],{},"\u002Fdocs-ux",[53,462,463],{},"Documents recently updated UX flows, navigation, and styling patterns.",[38,465,466,471],{},[53,467,468],{},[56,469,470],{},"\u002Finit",[53,472,473],{},"Documents the entire project.",[27,475,477],{"id":476},"utility-commands","Utility commands",[32,479,480,488],{},[35,481,482],{},[38,483,484,486],{},[41,485,233],{},[41,487,46],{},[48,489,490,500,510,520,530,540,550,560,570,580,590,600,610,620,630,641],{},[38,491,492,497],{},[53,493,494],{},[56,495,496],{},"\u002Fautocode-version",[53,498,499],{},"Prints currently installed versions of OpenCode and AutoCode.",[38,501,502,507],{},[53,503,504],{},[56,505,506],{},"\u002Fauthor-article",[53,508,509],{},"Authors a professional article or report from the supplied context.",[38,511,512,517],{},[53,513,514],{},[56,515,516],{},"\u002Fcontext",[53,518,519],{},"Report current session context.",[38,521,522,527],{},[53,523,524],{},[56,525,526],{},"\u002Fexplain",[53,528,529],{},"Explain code or project context.",[38,531,532,537],{},[53,533,534],{},[56,535,536],{},"\u002Ffix",[53,538,539],{},"Fix errors or requested issues.",[38,541,542,547],{},[53,543,544],{},[56,545,546],{},"\u002Fgit-commit",[53,548,549],{},"Creates a commit message and commits staged changes through the git commit subagent.",[38,551,552,557],{},[53,553,554],{},[56,555,556],{},"\u002Fgit-conflict",[53,558,559],{},"Handles git merge conflict work through the git conflict subagent.",[38,561,562,567],{},[53,563,564],{},[56,565,566],{},"\u002Fplan",[53,568,569],{},"Summarize and revise current plan.",[38,571,572,577],{},[53,573,574],{},[56,575,576],{},"\u002Frepeat-as-md",[53,578,579],{},"Repeats the last response inside a fenced Markdown code block.",[38,581,582,587],{},[53,583,584],{},[56,585,586],{},"\u002Frepeat-as-wiki",[53,588,589],{},"Repeats the last response in Atlassian Wiki Markup for Jira-style pasting.",[38,591,592,597],{},[53,593,594],{},[56,595,596],{},"\u002Frefactor",[53,598,599],{},"Safely refactor focused code.",[38,601,602,607],{},[53,603,604],{},[56,605,606],{},"\u002Freport-session",[53,608,609],{},"Reports on the entire current session.",[38,611,612,617],{},[53,613,614],{},[56,615,616],{},"\u002Freport-last",[53,618,619],{},"Reports on only the most recent user-requested assignment.",[38,621,622,627],{},[53,623,624],{},[56,625,626],{},"\u002Fresume",[53,628,629],{},"Resumes an interrupted session by calling the resume tool.",[38,631,632,636],{},[53,633,634],{},[56,635,216],{},[53,637,638,639,171],{},"Clean up sandbox files (if any). Alias for ",[56,640,212],{},[38,642,643,648],{},[53,644,645],{},[56,646,647],{},"\u002Ftests",[53,649,650],{},"Generate or improve tests.",[27,652,654],{"id":653},"job-files","Job files",[23,656,657,658,661,662,665,666,665,669,665,671,665,674,665,677,680,681,171],{},"Jobs are stored in ",[56,659,660],{},".agents\u002Fjobs\u002F{status}\u002F{job_name}\u002F",". The valid statuses are ",[56,663,664],{},"concepts",", ",[56,667,668],{},"drafts",[56,670,88],{},[56,672,673],{},"executing",[56,675,676],{},"facilitate",[56,678,679],{},"review",", and ",[56,682,683],{},"shelved",[32,685,686,695],{},[35,687,688],{},[38,689,690,693],{},[41,691,692],{},"Path",[41,694,46],{},[48,696,697,707,726,736,746],{},[38,698,699,704],{},[53,700,701],{},[56,702,703],{},"concept.md",[53,705,706],{},"Copy of the concept used to design the plan.",[38,708,709,714],{},[53,710,711],{},[56,712,713],{},"criteria.yml",[53,715,716,717,665,720,680,723,171],{},"Acceptance criteria mappings with IDs such as ",[56,718,719],{},"C1",[56,721,722],{},"C2",[56,724,725],{},"C3",[38,727,728,733],{},[53,729,730],{},[56,731,732],{},"plan.md",[53,734,735],{},"Solution plan covering problems, requirements, constraints, risks, and the selected proposal.",[38,737,738,743],{},[53,739,740],{},[56,741,742],{},"session.yml",[53,744,745],{},"OpenCode session IDs used for resume functionality.",[38,747,748,753],{},[53,749,750],{},[56,751,752],{},"solution.md",[53,754,755],{},"Chronological implementation and audit log.",[27,757,759],{"id":758},"database-inspection","Database inspection",[23,761,762],{},"AutoCode can inspect environment-configured databases through read-only tools and the hidden database specialist agent. This capability is intended for safe lookup and analysis, not schema changes, joins across multiple tables, or write operations.",[764,765,766,769,772,775],"ul",{},[165,767,768],{},"All database access is read-only.",[165,770,771],{},"Reads are limited to a single table at a time.",[165,773,774],{},"Identifiers must be simple schema, table, or field names.",[165,776,777,778,665,781,665,784,665,787,665,790,665,793,665,796,665,799,680,802,171],{},"Supported filter operators are ",[56,779,780],{},"=",[56,782,783],{},"!=",[56,785,786],{},"\u003C",[56,788,789],{},"\u003C=",[56,791,792],{},">",[56,794,795],{},">=",[56,797,798],{},"like",[56,800,801],{},"in",[56,803,804],{},"is_null",[27,806,808],{"id":807},"rest-response-lookup","REST response lookup",[23,810,811],{},"AutoCode can also make bounded REST requests and cache long responses for later lookup inside the current job.",[764,813,814,828,834],{},[165,815,816,817,820,821,665,824,827],{},"When the response body exceeds 400 characters, AutoCode caches it under the current job ",[56,818,819],{},"rest\u002F"," directory and includes ",[56,822,823],{},"response_name",[56,825,826],{},"job_name",", and guidance in the returned output.",[165,829,830,831,171],{},"Cache filename shape: ",[56,832,833],{},"{timestamp}_{METHOD}_{protocol}_{host-and-credentials}_{encoded-path}.json",[165,835,836],{},"Binary or non-UTF-8 responses are decoded into readable UTF-8 replacement text.",[23,838,839,840,842],{},"Cached response lookup tools resolve only inside the current job ",[56,841,819],{}," directory:",[764,844,845,860,871],{},[165,846,847,850,851,665,854,680,857,171],{},[56,848,849],{},"autocode_rest_response_read"," supports ",[56,852,853],{},"header",[56,855,856],{},"offset",[56,858,859],{},"limit",[165,861,862,850,865,867,868,171],{},[56,863,864],{},"autocode_rest_grep",[56,866,853],{}," and ",[56,869,870],{},"pattern",[165,872,873,876,877,171],{},[56,874,875],{},"autocode_rest_response_eval"," parses cached body JSON and supports only safe path expressions such as ",[56,878,879],{},"a.b[0]",[881,882,884],"h2",{"id":883},"see-also","See also",[764,886,887,895],{},[165,888,889,894],{},[890,891,893],"a",{"href":892},"configuration","Configuration"," — database and SSH environment variables.",[165,896,897,901],{},[890,898,900],{"href":899},"terminology","Terminology"," — job lifecycle terms.",[903,904,905],"style",{},"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 .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":102,"searchDepth":115,"depth":115,"links":907},[908,909,910,911,912,913,914,915,916,917],{"id":29,"depth":121,"text":30},{"id":94,"depth":121,"text":95},{"id":220,"depth":121,"text":221},{"id":334,"depth":121,"text":335},{"id":400,"depth":121,"text":401},{"id":476,"depth":121,"text":477},{"id":653,"depth":121,"text":654},{"id":758,"depth":121,"text":759},{"id":807,"depth":121,"text":808},{"id":883,"depth":115,"text":884},"md",{},"\u002Fusage",{"title":14,"description":25},"RQc2U517DXEhpZq0GeJUzrGONswF4NHzj9ID7Vj4KCA",1784015220743]