[{"data":1,"prerenderedAt":480},["ShallowReactive",2],{"content-home":3,"footer-links":472},{"id":4,"title":5,"body":6,"description":5,"extension":465,"meta":466,"navigation":467,"path":468,"seo":469,"stem":470,"__hash__":471},"content\u002Findex.md","",{"type":7,"value":8,"toc":451},"minimark",[9,25,28,31,43,46,48,53,139,143,148,168,173,199,203,206,231,235,238,253,287,293,297,309,313,320,340,343,347,356,363,367,390,394,417,421,427,431,447],[10,11,13,18],"div",{"align":12},"center",[14,15],"img",{"src":16,"alt":17},"logo.webp","AutoCode",[19,20,21],"p",{},[22,23,24],"i",{},"The workflow engine for traceable autonomous job execution",[26,27],"hr",{},[19,29,30],{},"AutoCode is an OpenCode plugin that turns rough conceptual ideas into completed solutions by means of structured workflow phases and optional review gates.",[19,32,33,34,38,39,42],{},"Run jobs autonomously with ",[35,36,37],"strong",{},"Auto mode",", or stay in control with ",[35,40,41],{},"Assist mode",", where AutoCode does the safe hard work and separates dangerous operations into guided manual steps.",[19,44,45],{},"No special UI required. AutoCode runs in OpenCode, keeps progress in version-controllable text files, and lets you track multiple jobs across their full lifecycle making it the ideal solution for remote development or server administration.",[26,47],{},[49,50,52],"h2",{"id":51},"features","Features",[54,55,56,64,71,78,84,90,97,104,111,118,125,132],"ul",{},[57,58,59,60,63],"li",{},"🧭 ",[35,61,62],{},"Structured lifecycle"," — move researched work from concept to solution in phases: concept ➔ draft ➔ executing job ➔ review.",[57,65,66,67,70],{},"🔎 ",[35,68,69],{},"Research"," — safely gather read-only evidence on project or non-project topics without making changes.",[57,72,73,74,77],{},"🧠 ",[35,75,76],{},"Design"," — brainstorm options, study feasibility, compare approaches, and report pros, cons, and risks before implementation starts.",[57,79,80,81,83],{},"🤖 ",[35,82,37],{}," — execute approved drafted jobs autonomously while keeping progress and review evidence in version-controllable files.",[57,85,86,87,89],{},"🧑‍💻 ",[35,88,41],{}," — keep a human in control while AutoCode reads the plan, recommends next steps, and tracks implementation progress.",[57,91,92,93,96],{},"⚠️ ",[35,94,95],{},"Safe hand-offs"," — provide a thorough manual task tutorial when an operation is unsafe.",[57,98,99,100,103],{},"⚡ ",[35,101,102],{},"Token-optimized workflows"," — smart orchestrators delegate to faster specialists to improve performance and reduce token use.",[57,105,106,107,110],{},"🗄️ ",[35,108,109],{},"Read-only database inspection"," — discover configured database tables and read one table at a time without write access.",[57,112,113,114,117],{},"🧪 ",[35,115,116],{},"Sandboxed execution"," — run supported risky commands in Linux bubblewrap sandboxes when the host supports user namespaces.",[57,119,120,121,124],{},"📦 ",[35,122,123],{},"Cross-project tasking"," — delegate investigation or edits to isolated OpenCode sessions in other directories after permission checks.",[57,126,127,128,131],{},"🔐 ",[35,129,130],{},"SSH tool suite"," — run remote commands and manage files through environment-keyed tools.",[57,133,134,135,138],{},"🧹 ",[35,136,137],{},"Agent cleanup"," — Agents remove temporary files and stop stray processes they started after debugging.",[49,140,142],{"id":141},"installation","Installation",[144,145,147],"h3",{"id":146},"prerequisites","Prerequisites",[54,149,150,160],{},[57,151,152,159],{},[153,154,158],"a",{"href":155,"rel":156},"https:\u002F\u002Fopencode.ai",[157],"nofollow","OpenCode"," is required to load and use AutoCode.",[57,161,162,163,167],{},"The npm package \u002F plugin entry is ",[164,165,166],"code",{},"@ahumandev\u002Fautocode",".",[169,170,172],"h4",{"id":171},"optional","Optional",[54,174,175,183,191],{},[57,176,177,182],{},[153,178,181],{"href":179,"rel":180},"https:\u002F\u002Fgithub.com\u002Fcontainers\u002Fbubblewrap",[157],"Bubblewrap"," is required only for Linux sandbox execution.",[57,184,185,190],{},[153,186,189],{"href":187,"rel":188},"https:\u002F\u002Fbun.sh",[157],"Bun"," is required only to build the plugin from source or run tests.",[57,192,193,198],{},[153,194,197],{"href":195,"rel":196},"https:\u002F\u002Fgithub.com\u002FChromeDevTools\u002Fchrome-devtools-mcp",[157],"chrome-devtools-mcp"," is required only for Chrome DevTools MCP server support.",[144,200,202],{"id":201},"installation-for-llm-agents","Installation for LLM Agents",[19,204,205],{},"Fetch installation guide and follow it:",[207,208,212],"pre",{"className":209,"code":210,"language":211,"meta":5,"style":5},"language-bash shiki shiki-themes github-light github-dark","curl -s https:\u002F\u002Fraw.githubusercontent.com\u002Fahumandev\u002Fautocode\u002Frefs\u002Fheads\u002Fmain\u002Fdocs\u002Finstallation.md\n","bash",[164,213,214],{"__ignoreMap":5},[215,216,219,223,227],"span",{"class":217,"line":218},"line",1,[215,220,222],{"class":221},"sScJk","curl",[215,224,226],{"class":225},"sj4cs"," -s",[215,228,230],{"class":229},"sZZnC"," https:\u002F\u002Fraw.githubusercontent.com\u002Fahumandev\u002Fautocode\u002Frefs\u002Fheads\u002Fmain\u002Fdocs\u002Finstallation.md\n",[144,232,234],{"id":233},"installation-for-humans","Installation for Humans",[19,236,237],{},"OpenCode installs npm plugins automatically at startup when they are listed in the global plugin configuration.",[19,239,240,241,244,245,248,249,252],{},"Use the global OpenCode config at ",[164,242,243],{},"~\u002F.config\u002Fopencode\u002Fopencode.json"," or ",[164,246,247],{},"~\u002F.config\u002Fopencode\u002Fopencode.jsonc",", then merge the plugin entry into the existing ",[164,250,251],{},"plugin"," array instead of overwriting the file.",[207,254,258],{"className":255,"code":256,"language":257,"meta":5,"style":5},"language-json shiki shiki-themes github-light github-dark","{\n  \"plugin\": [\"@ahumandev\u002Fautocode\"]\n}\n","json",[164,259,260,266,281],{"__ignoreMap":5},[215,261,262],{"class":217,"line":218},[215,263,265],{"class":264},"sVt8B","{\n",[215,267,269,272,275,278],{"class":217,"line":268},2,[215,270,271],{"class":225},"  \"plugin\"",[215,273,274],{"class":264},": [",[215,276,277],{"class":229},"\"@ahumandev\u002Fautocode\"",[215,279,280],{"class":264},"]\n",[215,282,284],{"class":217,"line":283},3,[215,285,286],{"class":264},"}\n",[19,288,289,290,292],{},"If your config already contains other plugins or settings, keep them and add ",[164,291,166],{}," to the existing array.",[169,294,296],{"id":295},"verify-installation","Verify installation",[298,299,300,303,306],"ol",{},[57,301,302],{},"Save the updated OpenCode config.",[57,304,305],{},"Start or restart OpenCode.",[57,307,308],{},"Confirm OpenCode loads AutoCode commands or agents after startup.",[144,310,312],{"id":311},"update-the-plugin-version","Update the plugin version",[19,314,315,316,319],{},"To update the public package version, change the plugin entry to ",[164,317,318],{},"@ahumandev\u002Fautocode@latest"," in your OpenCode config, save the file, and restart OpenCode.",[207,321,325],{"className":322,"code":323,"language":324,"meta":5,"style":5},"language-jsonc shiki shiki-themes github-light github-dark","{\n  \"plugin\": [\"@ahumandev\u002Fautocode@latest\"]\n}\n","jsonc",[164,326,327,331,336],{"__ignoreMap":5},[215,328,329],{"class":217,"line":218},[215,330,265],{},[215,332,333],{"class":217,"line":268},[215,334,335],{},"  \"plugin\": [\"@ahumandev\u002Fautocode@latest\"]\n",[215,337,338],{"class":217,"line":283},[215,339,286],{},[19,341,342],{},"OpenCode re-installs the requested npm plugin version during startup.",[144,344,346],{"id":345},"uninstall","Uninstall",[19,348,349,350,352,353,355],{},"Remove ",[164,351,166],{}," from the OpenCode ",[164,354,251],{}," array, save the config, and restart OpenCode.",[19,357,358,359,362],{},"If you previously used the repository-only shim workflow, also remove ",[164,360,361],{},"~\u002F.config\u002Fopencode\u002Fplugins\u002Fautocode.js"," if present.",[144,364,366],{"id":365},"troubleshooting","Troubleshooting",[54,368,369,376,379,387],{},[57,370,371,372,244,374,167],{},"Confirm the config file is ",[164,373,243],{},[164,375,247],{},[57,377,378],{},"Confirm your JSON or JSONC stays valid after merging the plugin entry.",[57,380,381,382,244,384,386],{},"Confirm the plugin entry uses ",[164,383,166],{},[164,385,318],{}," exactly.",[57,388,389],{},"Restart OpenCode after every config change so startup installation can run again.",[49,391,393],{"id":392},"core","Core",[54,395,396,403,410],{},[57,397,398,402],{},[153,399,401],{"href":400},"configuration","Configuration"," — config locations, keys, model tiers, and DB\u002FSSH environment variables.",[57,404,405,409],{},[153,406,408],{"href":407},"usage","Usage"," — more details on how to use AutoCode.",[57,411,412,416],{},[153,413,415],{"href":414},"terminology","Terminology"," — glossary of AutoCode concepts.",[49,418,420],{"id":419},"reference","Reference",[54,422,423],{},[57,424,425,416],{},[153,426,415],{"href":414},[49,428,430],{"id":429},"development-distribution","Development & Distribution",[54,432,433,440],{},[57,434,435,439],{},[153,436,438],{"href":437},"development","Development"," — architecture, local setup, commands, testing, and local plugin deployment.",[57,441,442,446],{},[153,443,445],{"href":444},"distribution","Distribution Guide"," — distributing AutoCode on public registries.",[448,449,450],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}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);}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":5,"searchDepth":268,"depth":268,"links":452},[453,454,462,463,464],{"id":51,"depth":268,"text":52},{"id":141,"depth":268,"text":142,"children":455},[456,457,458,459,460,461],{"id":146,"depth":283,"text":147},{"id":201,"depth":283,"text":202},{"id":233,"depth":283,"text":234},{"id":311,"depth":283,"text":312},{"id":345,"depth":283,"text":346},{"id":365,"depth":283,"text":366},{"id":392,"depth":268,"text":393},{"id":419,"depth":268,"text":420},{"id":429,"depth":268,"text":430},"md",{},true,"\u002F",{"description":5},"index","uGvWQcRtP1YddXmwneXBa0oqhZxIDfx80yOhXsi1Wjg",[473,477],{"path":474,"title":475,"type":476,"isExternal":467},"https:\u002F\u002Fgithub.com\u002Fahumandev\u002Fautocode","GitHub","link",{"path":478,"title":479,"type":476,"isExternal":467},"https:\u002F\u002Fwww.npmjs.com\u002F@ahumandev\u002Fautocode","NPM",1784015220543]