19. Current OpenCode Reference
This lesson is a reference sheet for the concepts used in this course.
Official documentation
- OpenCode documentation: https://opencode.ai/docs
- Agents: https://opencode.ai/docs/agents
- Skills: https://opencode.ai/docs/skills
- Providers: https://opencode.ai/docs/providers
- Permissions: https://opencode.ai/docs/permissions
- CLI: https://opencode.ai/docs/cli
- Instructions / AGENTS.md: https://opencode.ai/docs/instructions
AGENTS.md
Use AGENTS.md for persistent project guidance such as:
- Build commands
- Architecture notes
- Code conventions
- Verification requirements
The official documentation recommends committing project AGENTS.md files to Git.
Agents
OpenCode documents:
- Primary agents
- Subagents
- Custom Markdown agents
- Agent-specific models
- Agent-specific permissions
Project agents are stored under:
.opencode/agents/
Global agents are stored under:
~/.config/opencode/agents/
A Markdown agent can use frontmatter such as:
---
description: Reviews code
mode: subagent
---
The filename becomes the agent name.
Skills
Project skills are stored under:
.opencode/skills/<name>/SKILL.md
Skills are loaded on demand.
Providers
Use /connect to connect a provider.
Use the model picker/current documentation to see available models.
OpenCode documents support for many providers and local models; exact availability changes over time.
Permissions
The documented permission concepts include:
allow
ask
deny
Use least privilege.
Version note
OpenCode is actively developed. Configuration syntax can evolve.
If your installed version differs from an example in this course:
- Run the relevant
--helpcommand. - Check the current official OpenCode documentation.
- Prefer the schema/documentation for your installed version.
This course intentionally teaches the concepts separately from version-specific configuration details.