A configurable OpenCode plugin that turns task checklists into a fully automated workflow. It initializes a project-local orchestration system with editable prompts, state management, and per-step CLI command sequences. The plugin runs an event-driven sta
npm install fullautoagentAutomates a simple, repeatable CLI workflow inside OpenCode. The plugin initializes a project-local state machine, executes per-state CLI sequences, and keeps the workflow state in a single JSON file. Everything is editable: commands, CLI sequences, and state rules.
- Initializes a .opencode/full-auto workspace with commands, CLI sequences, and state.
- Runs a fixed workflow loop: pick_next → plan → implement → review → done with a reserved stop state.
- Executes CLI sequences for each state and then runs a lightweight update_state_status step.
- Stores the current state in .opencode/full-auto/state.json.
- Inserts a managed header block at the top of AGENTS.md to define the state rules.
The plugin registers two styles of commands (both work):
- full-auto init / full-auto start / full-auto stop / full-auto run-once
- full-auto-init / full-auto-start / full-auto-stop / full-auto-run-once
full-auto init creates:
``
.opencode/full-auto/
state.json
checklist.md
commands/
pick_next.md
plan.md
implement.md
review.md
done.md
stop.md
update_state_status.md
cli/
pick_next.json
plan.json
implement.json
review.json
done.json
stop.json
update_state_status.json
`
It also creates/updates AGENTS.md and writes a managed header block that defines valid states and how transitions are decided.
1. Read the current state from .opencode/full-auto/state.json.update_state_status
2. Execute the CLI sequence for that state.
3. Execute (fast model) to update state.json.
4. Repeat until stopped.
The CLI sequences are simple JSON files containing a delay and a list of commands.
Example cli/plan.json:
`json`
{
"delay_ms": 800,
"commands": ["/exit", "opencode --model gpt-5", "/plan"]
}
- OpenCode CLI installed and configured
- Node.js 18+ or Bun runtime
---
For Humans
Option A: Let an LLM do it
Paste this into any LLM agent (Claude Code, OpenCode, Cursor, etc.):
``
Install the fullautoagent plugin for OpenCode and initialize Full-Auto in my project by following: https://raw.githubusercontent.com/maystudios/OpenCode-FullAutoAgent/main/README.md
Option B: Manual setup
1. Add the plugin to ~/.config/opencode/opencode.json:
`json`
{
"plugin": ["fullautoagent@latest"]
}
2. Install locally in your project:
`bash`
npm install fullautoagent --save
3. Initialize inside OpenCode:
`bash`
opencode
Then run:
``
/full-auto init
4. Start the workflow:
``
/full-auto start
For LLM Agents
1. Edit the OpenCode configuration file at ~/.config/opencode/opencode.json
> Note: This path works on all platforms. On Windows, ~ resolves to your user home directory (e.g., C:\Users\YourName).
2. Add the plugin to the plugin array:
`json`
{
"plugin": ["fullautoagent@latest"]
}
3. Install the plugin locally in the project:
`bash`
npm install fullautoagent --save
4. Start OpenCode and run /full-auto init to create the workflow structure.
5. Run /full-auto start to begin the automation loop.
`bash`
opencode
Then inside OpenCode:
``
/full-auto init
/full-auto start
- OpenCode does not load globally installed npm packages as plugins.
- The plugin must be listed in opencode.json under "plugin" (singular, not "plugins").npm install fullautoagent --save
- The plugin must be installed locally (), not just globally.
---
Installing fullautoagent globally (npm install -g) only installs an npm package. OpenCode loads plugins only from:
- .opencode/plugins/ directoryopencode.json
- config under "plugin" array (as local dependencies)
If OpenCode doesn't list the plugin:
1. Add to ~/.config/opencode/opencode.json:
`json`
{
"plugin": ["fullautoagent@latest"]
}
2. Install locally:
`bash`
npm install fullautoagent --save
---
`bash`
git clone https://github.com/maystudios/OpenCode-FullAutoAgent.git
cd OpenCode-FullAutoAgent
npm install
npm run build
npm link
Then add to your OpenCode config:
`json`
{
"plugin": ["fullautoagent"]
}
---
Navigate to your project directory and run:
`bash`
opencode
Then inside OpenCode:
``
/full-auto init
This creates the .opencode/full-auto/ workspace with all default templates.
| Command | Description |
| --------------------- | ---------------------------------------------------- |
| /full-auto init | Initialize the workflow structure in current project |/full-auto start
| | Start the automated workflow loop |/full-auto stop
| | Stop the running loop after current cycle |/full-auto run-once
| | Execute a single workflow cycle |
After init, edit the files in .opencode/full-auto/ to customize:
- commands/\*.md - Prompt templates for each workflow step
- cli/\*.json - CLI sequences (delays, model selection, command order)
- checklist.md - Your project task backlog
- state.json - Current workflow state (usually managed automatically)
Build and tooling:
- mise run buildmise run test
- mise run lint
- mise run lint:fix
- mise run format
-
Testing fallback if mise or bun is unavailable:
- npx vitest run
Note: the tool import uses the explicit subpath @opencode-ai/plugin/tool to avoid missing re-exports in some installs.
The authoritative project concept lives in docs/concept.md and should be updated if behavior changes.
MIT License. See LICENSE`.