opencode-squad manual

About OpenCode

OpenCode is the agentic coding environment that runs this plugin. It gives you an AI partner inside your development workflow, connects that partner to models and project tools, and provides the runtime where agents can read code, reason about changes, and execute approved actions.

Without OpenCode, opencode-squad has nothing to attach to. The plugin is built to extend OpenCode rather than replace it: OpenCode provides the application, session, and tool system; opencode-squad adds a curated team of agents, safer helper tools, and project-level conventions on top.

About our Squad

opencode-squad is an OpenCode plugin that loads a squad of primary agents, specialist subagents, and slash-command agents for practical software work.

The goal is not to make the assistant louder or more complicated. The goal is to make it easier to work in a structured way: primary agents handle broad collaboration, specialist agents take focused research or implementation tasks, and custom tools reduce repetitive setup around configuration, documentation, containers, and sandboxed execution.

The plugin also keeps safety boundaries visible. Configuration lives in a strict squad.json file, machine-local paths stay out of project config, and helper containers/sandboxes are used where isolation makes the workflow safer.

Start here

• Installation explains how to load the plugin locally or by package name.
• Configuration explains the squad.json configuration model and links to focused configuration pages.
• Agents summarizes the bundled agents and routing keys.
• Tools describes the custom tools and their operational risk levels.

Design goals

• Keep the plugin usable with minimal configuration.
• Make model routing explicit and stable through named handlers.
• Keep machine-local paths and secrets out of project configuration.
• Give agents useful tools while preserving clear safety boundaries.