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 is a thinner companion. Shared skills live in a separate repo. dot keeps a checkout detached at the latest main and links it into ~/.agents/skills/.
| Piece | Why |
|---|---|
| Skills | Shared catalogue plus repo-local skills |
| OpenCode | Day-to-day sessions, slash commands, plugins, Herdr panes |
| Pi | Lightweight companion sessions |
Shared wiring
| Mechanism | Role |
|---|---|
dot agent sync |
Mirror global AGENTS into other harness instruction files |
dot mcp sync |
Regenerate MCP configs from the private overlay; OpenCode repos opt in per checkout |
dot skills |
Check and apply updates from the skills repo |
~/.agents/skills/ |
Shared skills linked from the latest skills repo main |
OpenCode owns the full agent, command, and plugin stack. Pi reuses skills and AGENTS, not that stack.