LearnCen Docs
Guides 2 min read

19. Current OpenCode Reference

This lesson is a reference sheet for the concepts used in this course.

Official documentation

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:

  1. Run the relevant --help command.
  2. Check the current official OpenCode documentation.
  3. Prefer the schema/documentation for your installed version.

This course intentionally teaches the concepts separately from version-specific configuration details.