🚀 OpenCode Masterclass — Course from Beginner to Advanced¶

The most complete hands-on OpenCode (V2) course. 32 practical lessons across 6 modules plus capstone projects, covering everything: agents, skills, commands, plugins, MCP servers, CI/CD, API, SDK and enterprise.

🇧🇷 Leia em português — the full lesson content is written in Portuguese (PT-BR).

What is this?¶

OpenCode is an open source AI coding agent that runs in your terminal (TUI), desktop and web. This repository is a progressive, project-based course/guide that teaches you to master it end to end. Every lesson has an objective, content, a hands-on challenge, and links to the official documentation.

Who is it for?¶

Developers new to OpenCode who want a structured path (Module 01 → 06)
Teams adopting an AI coding agent and needing agents, permissions, policies, and CI/CD patterns
Builders integrating OpenCode via HTTP API, JavaScript client, and SDK

Roadmap¶

Module	Title	Level	Lessons
01	Fundamentals & Configuration	🟢 Beginner	5
02	Customizing the Agent	🔵 Intermediate	7
03	Extending OpenCode (agents, plugins, websearch)	🟠 Advanced	5
04	Automation & CI/CD	🟠 Advanced	3
05	Integration & Platform (API, client, SDK)	🟣 Specialist	4
06	Operations & Enterprise (troubleshooting, cost, Console)	🟣 Specialist	5
Projects	Capstone Projects	🟣 Specialist	3

Topics covered¶

agents · skills · commands · plugins · MCP · permissions · policies · providers · models · websearch · references · compaction · CI/CD · GitHub Actions · HTTP API · JavaScript client · SDK · ACP · Console (enterprise) · V1→V2 migration

Quick start¶

git clone https://github.com/murilogteixeira/opencode-masterclass.git
cd opencode-masterclass

# Install OpenCode V2
curl -fsSL https://opencode.ai/v2/install | bash

# Connect a provider and pick a model
opencode   # then run: /connect  and  /models

Then follow the modules in order — the lessons are in Portuguese, each ending with a practical challenge.

Useful links¶

📄 Cheat Sheet · 🧭 Study path · 📖 Glossary · ❓ FAQ
Official docs: opencode.ai/v2/docs

Contributing¶

PRs and issues are welcome — see CONTRIBUTING.md. If this course helps you, please ⭐ star the repo so others can find it.