Features

Implementation Modes

• 💡 Advise mode — guidance: agent researches topics, answers questions, and guides manual implementation.
• 🧑‍💻 Assist mode — interactive: you make decisions while agent orchestration does the work and suggests next steps.
• 🤖 Auto mode — autonomous: agent executes structured design work until completion.

Workflow Optimizations

• 📦 Cross-project tasking — delegate investigation or edits to isolated OpenCode sessions in external directories.
• 🪙 Cost-saving workflows — improve performance and reduce token usage with smart orchestration, tiered agent models, Caveman English.
• 🔒 Secret-safe tools — agents never see passwords or secrets; predefined keys resolve credentials at tool runtime.
• ⚠️ Safe hand-offs — provide a thorough manual task tutorial when an operation is unsafe.
• 📚 Self-learning memory — auto capture corrections, environment quirks, permissions, and user preferences as skills for future sessions.
• 🧹 Agent cleanup — agents remove temporary files and stop stray processes they started after debugging.

Build-in Tools

• 🗄️ Read-only database inspection — discover configured database tables and read one table at a time without write access.
• 🌐 HTTP REST client — simulate API calls for troubleshooting.
• 🔀 Git tools — inspect changes and commit updates to Git repositories.
• 🔐 SSH tools — run remote commands and manage files through environment-keyed tools.
• 🧪 Sandbox isolation — agents automatically manage and experiment in their own isolated sandboxes.
• 🛠️ Self-building tools — agents create durable per-job Node .mjs tools, reconcile dependencies, run finite scripts, and manage long-running services.

As well as OpenCode bundled tools.

Installation

Install AutoCode as public OpenCode plugin. AI agents use installation guide; humans use human guide.

Prerequisites

• OpenCode is required to load and use AutoCode.
• The npm package / plugin entry is @ahumandev/autocode.

Optional

• Bubblewrap is required only for Linux sandbox execution.
• Bun is required only to build the plugin from source, run tests, or install the local shim.
• MCP servers MCP servers are optional integrations.

Installation for LLM Agents

Fetch this guide and follow its OS branch.

Windows CMD

curl -s https://raw.githubusercontent.com/ahumandev/autocode/refs/heads/main/docs/installation.md

Linux Bash

curl -s https://raw.githubusercontent.com/ahumandev/autocode/refs/heads/main/docs/installation.md

The guide detects OS at startup: use CMD for Windows agents and Bash for Linux agents.

Installation for Humans

Use human installation guide.

Windows route uses native CMD. Linux route uses Bash and includes optional Bubblewrap setup. Both install the public plugin with:

opencode plugin @ahumandev/autocode@latest -g -f

Usage

AutoCode is an OpenCode plugin. It does not start a web server or expose a local URL. It registers managed agents, slash commands, generated skills, and tools.

At startup, AutoCode detects OS. Agents use CMD on Windows and Bash on Linux. Windows does not register sandbox agents or tools; Linux sandbox execution uses Bubblewrap when available. Generated skills are written to <home>/.agents/skills.

Primary Agents

| | Agent | Purpose | | ---- | ---------- | --------------------------------------- | | 💡 | advise | Research topics, answer questions, and guide manual work. | | 📐 | design | Design and propose solutions. | | 🤖 | auto | Autonomously solve problems. | | 🧑‍💻 | assist | Assist interactively with problems. |

Behavioural Differences

| Agent | Investigations | Next Action | Apply Changes | | ------------- | -------------- | --------------- | ------------- | | 💡 advise | Autonomous | Interactive | Human | | 🧑‍💻 assist | Autonomous | Interactive | AI* | | 🤖 auto | Autonomous | Autonomous | AI* |

*Except dangerous tasks.

Typical Workflow

flowchart TD
  Concepts([.agents/concepts])
  Concepts -- 📐 design --> Design[.agents/job/.../design.md]
  
  Design -- 💡 advise --> Advise([manual execution])
  Design -- 🧑‍💻 assist --> Assist([interactive execution])
  Design -- 🤖 auto --> Auto([autonomous execution])
  

Switch any time between 💡 advise and 🧑‍💻 assist and 🤖 auto when work needs a different autonomy level.

Reference

• Installation — AI installation guide with native CMD and Bash branches.
• Documentation — human installation, verification, update, uninstall, and troubleshooting.

Development

Build and local shim installation use cross-platform Bun scripts. Bun is required for source builds and tests, not public plugin installation.