mirror of
https://github.com/msitarzewski/agency-agents
synced 2026-04-25 11:18:05 +00:00
43c66a7b89
Reflect the switch to agents/ (plural), hex color codes, mode: subagent, and @agent-name invocation in both the OpenCode integration README and the main README's OpenCode section.
63 lines
1.4 KiB
Markdown
63 lines
1.4 KiB
Markdown
# OpenCode Integration
|
|
|
|
OpenCode agents are `.md` files with YAML frontmatter stored in
|
|
`.opencode/agents/`. The converter maps named colors to hex codes and adds
|
|
`mode: subagent` so agents are invoked on-demand via `@agent-name` rather
|
|
than cluttering the primary agent picker.
|
|
|
|
## Install
|
|
|
|
```bash
|
|
# Run from your project root
|
|
cd /your/project
|
|
/path/to/agency-agents/scripts/install.sh --tool opencode
|
|
```
|
|
|
|
This creates `.opencode/agents/<slug>.md` files in your project directory.
|
|
|
|
## Activate an Agent
|
|
|
|
In OpenCode, invoke a subagent with the `@` prefix:
|
|
|
|
```
|
|
@frontend-developer help build this component.
|
|
```
|
|
|
|
```
|
|
@reality-checker review this PR.
|
|
```
|
|
|
|
You can also select agents from the OpenCode UI's agent picker.
|
|
|
|
## Agent Format
|
|
|
|
Each generated agent file contains:
|
|
|
|
```yaml
|
|
---
|
|
name: Frontend Developer
|
|
description: Expert frontend developer specializing in modern web technologies...
|
|
mode: subagent
|
|
color: "#00FFFF"
|
|
---
|
|
```
|
|
|
|
- **mode: subagent** — agent is available on-demand, not shown in the primary Tab-cycle list
|
|
- **color** — hex code (named colors from source files are converted automatically)
|
|
|
|
## Project vs Global
|
|
|
|
Agents in `.opencode/agents/` are **project-scoped**. To make them available
|
|
globally across all projects, copy them to your OpenCode config directory:
|
|
|
|
```bash
|
|
mkdir -p ~/.config/opencode/agents
|
|
cp integrations/opencode/agents/*.md ~/.config/opencode/agents/
|
|
```
|
|
|
|
## Regenerate
|
|
|
|
```bash
|
|
./scripts/convert.sh --tool opencode
|
|
```
|