~/.config/opencode/
opencode.json global, AGENTS.md, commands/, skills/ y plugins/. Si la app de escritorio se cae, suele ser un plugin. Vacía la clave plugin y vuelve a abrir. Ver solución de problemas de escritorio.
Lista de funciones del producto
Lo que OpenCode hace de verdad
Cada título de abajo es una capacidad con nombre de la página de OpenCode, la intro, el TUI, los agentes o la documentación de permisos. Si viniste a instalar, salta a la página de descarga.
Tres superficies, un agente
La página principal llama a esto "cualquier editor": una interfaz de terminal, una app de escritorio y una extensión de IDE. El escritorio es la pieza que ganó pestañas para las sesiones activas. La página oficial de descarga sigue listando Terminal primero, luego Escritorio, luego Extensiones.
La config del TUI vive en tui.json (tema, atajos, cursor, sonidos de atención). La config de runtime vive en opencode.json. No son el mismo archivo.
Una ventana de escritorio en blanco en Windows suele ser WebView2. Ese recorrido está en las guías.
Modelos, inicios de sesión y Zen
"Cualquier modelo" en la página principal significa más de 75 proveedores de LLM a través de Models.dev, incluidos modelos locales. /connect agrega un proveedor. Los modelos se nombran como provider/model, por ejemplo openai/gpt-4.1 o opencode/kimi-k2.
| Ruta | Qué es |
|---|---|
| /connect | Agrega un proveedor y pega una API key, o inicia sesión en Copilot, ChatGPT, Claude o Zen. |
| /models | Abre el selector. Corre opencode models en una shell para listar lo que de verdad puedes llamar. |
| OpenCode Zen | Modelos elegidos a mano que el proyecto probó para agentes de código, para que la calidad del proveedor sea menos una lotería. |
| GitHub Copilot | Inicia sesión con GitHub. v1.18.31 pide summarized adaptive thinking para los modelos de Copilot. |
| ChatGPT Plus/Pro | Inicia sesión con OpenAI. v1.18.29 corrigió la visibilidad de gpt-6-astra para usuarios con suscripción de OpenAI. |
| Modelos locales | La página principal y el FAQ dicen que puedes conectar modelos locales por la misma lista de proveedores. |
El ciclo del agente
- Tab · Plan / Build
- Build es el agente principal por defecto, con las herramientas encendidas. Plan está restringido: edit y bash quedan en ask o deny para que el modelo proponga trabajo sin tocar el árbol.
- /init · AGENTS.md
- Configuración guiada que escribe las reglas del proyecto. Haz commit del archivo. Las reglas globales también pueden vivir en ~/.config/opencode/AGENTS.md.
- /undo · /redo
- Revierte o restaura el último turno del usuario y sus cambios de archivo. Se necesita Git. Puedes deshacer más de una vez.
- /share · /unshare
- Publica una sesión para revisión o depuración. Las conversaciones no se comparten hasta que corres el comando.
Los permisos son el riel de seguridad
Desde v1.1.1 el boolean viejo de tools quedó dentro de permission. Cada regla es allow, ask o deny. opencode --auto aprueba los ask que no estén en deny.
- read / edit / bash / grep / glob
- Herramientas de archivos y shell. Los patrones pueden poner allow a
git *y deny arm *. - external_directory
- Se dispara cuando una herramienta sale del directorio de trabajo. El valor por defecto es ask. Expandir ~ en home no salta esta guarda.
- doom_loop
- Se dispara cuando la misma llamada de herramienta se repite tres veces con la misma entrada. El valor por defecto es ask.
- archivos .env
- read queda en allow, pero
*.envy*.env.*quedan en deny por defecto.*.env.examplese queda en allow.
MCP, agentes y archivos del proyecto
La config vive en carpetas conocidas. Estas rutas son las que nombra de verdad la cheatsheet.
.opencode/ en el repo
Config, comandos, skills y plugins por proyecto. El markdown del agente puede poner mode: subagent y deny edit para que un revisor no pueda escribir archivos.
/mcp
Lista los servidores MCP configurados y su estado de conexión. Las claves de permiso pueden apuntar a un servidor con patrones como mymcp_*.
Pestañas de escritorio
El titular de la página de descarga: organiza el trabajo y las sesiones activas con pestañas en macOS, Windows y Linux.