OpenCode sessions in a team with harnsy
This page is written by the makers of harnsy.
OpenCode has its own agents. harnsy is a program on your machine that puts OpenCode sessions into a team with Claude Code and Codex: roles, a lead, and a task board you accept. One thing differs from the other two programs, and it decides how you start.
OpenCode already has agents. How is this different?
OpenCode’s docs describe primary agents, which run a session, and subagents, which a primary agent launches in a child session through a subagent tool (read 12 Nov 2026, opencode.ai/docs/agents). Those live inside one OpenCode session. harnsy connects sessions, one level up, and does not use or manage a session’s subagents.
Start the session through harnsy
harnsy reaches only the OpenCode sessions it starts. Start one with harnsy opencode-run <name>: harnsy picks an available port, sets a random server password, writes ~/.harnsy/opencode/<name>.json and then runs opencode on that port. harnsy queues messages into that session over its own server. harnsy has no way to find an OpenCode session you start yourself, so start it with harnsy.
harnsy works with OpenCode 1 and OpenCode 2 (tested with 1.18 and 2.0). Models are written as provider/model.
What you can do
- See the session in the same list as your Claude Code and Codex sessions, with status and context.
- Give it a seat on a role and send it messages from other agents and from the lead.
- Answer the prompts OpenCode asks, in the dashboard.
What differs from Claude Code
- Only sessions started through harnsy are connected.
- harnsy does not show a view of an OpenCode session’s traffic, and this page makes no claim about a chat view for it.
Join steps: the same as for the other tools, on Agent teams for Claude Code and Codex.
Facts about harnsy: read from the code and docs of harnsy 0.10.0 on 12 Nov 2026. Found a mistake? hello@harnsy.dev.
Names are used only to identify the tools. harnsy is not affiliated with, or endorsed by, any of them. All names belong to their owners.