Agents
How OpenCode, skills, and companion harnesses fit together.
Coding agents in this setup share skills and AGENTS guidance. OpenCode is the primary harness; Pi and Cursor are thinner companions. Shared skills live in a separate repo, pinned and stowed from this checkout.
| Piece | Why |
|---|---|
| Skills | Shared catalogue plus repo-local skills |
| OpenCode | Day-to-day sessions, slash commands, plugins, Herdr panes |
| Pi | Lightweight companion sessions |
| Cursor | IDE-embedded agent and launchers |
Shared wiring
| Mechanism | Role |
|---|---|
dot agents-sync |
Mirror global AGENTS into other harness instruction files |
dot mcp-sync |
Regenerate MCP configs from the private overlay for each harness |
dot skills |
Check and apply updates from the skills repo |
~/.agents/skills/ |
Stowed shared skills (from the pinned skills submodule) |
OpenCode owns the full agent, command, and plugin stack. Pi and Cursor reuse skills and/or AGENTS, not that stack.