OpenCode
Run OpenCode as a Subshell agent.
Before you start
Install opencode using the vendor instructions and authenticate it under the execution account. Ask an administrator to enable the harness under Settings → Server Settings → Plugins in the server dashboard's sidebar. Follow Install an agent CLI to confirm detection on the target node.
Launch
- In the server dashboard's sidebar, choose Subshells, select New subshell, and choose OpenCode.
- Select a preset or configure the supported launch settings.
- Choose the target node and an existing project directory.
- Launch and confirm that the CLI opens normally.
The plugin detects opencode through PATH and its known locations. OPENCODE_PATH can identify the binary explicitly in the execution environment. Before changing that override, see Files and paths for configuration locations and service-environment guidance.
MCP and session behavior
Subshell injects a local MCP entry into the launch configuration. Preset configuration is merged with the required Subshell MCP configuration. The built-in plugin declares MCP and settings capabilities; it doesn't declare automatic conversation resumption or attention hooks.
Subshell runs the real CLI rather than proxying its provider API. Provider configuration, usage limits, and CLI-specific permissions remain the agent's own settings.
Next steps
Read MCP configuration, Presets, and Agent and launch errors.
Edit on GitHubLast updated on
