Capitulo 20: Tips de Productividad

< Volver al Indice del Tutorial

Este capitulo reune consejos y configuraciones avanzadas para sacar el maximo provecho de OpenCode en tu flujo de trabajo diario.

Keybinds Personalizados

OpenCode permite configurar atajos de teclado personalizados en tui.json. Puedes reemplazar los keybinds por defecto o agregar nuevos:

{
  "tui": {
    "keybinds": {
      "submit": "ctrl+enter",
      "paste": "ctrl+v",
      "cancel": "escape"
    }
  }
}

Revisa los keybinds disponibles con ? dentro de la TUI para ver la lista completa de acciones configurables.

Themes

Cambia el tema visual de la TUI para adaptarlo a tu preferencia o al tema de tu terminal:

{
  "tui": {
    "theme": "catppuccin-mocha"
  }
}

OpenCode incluye varios themes integrados. Tambien puedes definir colores custom en la configuracion si ningun tema predefinido se ajusta a tu gusto.

Sessions Management

Las sesiones son el corazon del flujo de trabajo en OpenCode:

• /session: lista y gestiona sesiones dentro de la TUI
• --continue: retoma la ultima sesion al iniciar

  opencode --continue

• --fork: crea una nueva sesion bifurcando la actual (conserva el historial)
• Nombrar sesiones: asigna nombres descriptivos para encontrarlas facilmente despues

Las sesiones se persisten en SQLite, asi que sobreviven a reinicios y puedes buscar entre ellas.

opencode stats

Monitorea tu consumo de tokens y costos acumulados:

opencode stats

Muestra un desglose por proveedor y modelo:

• Tokens de entrada consumidos
• Tokens de salida generados
• Costo total acumulado por modelo
• Historico de uso por periodo

Esto es fundamental para controlar costos, especialmente cuando usas modelos premium en proyectos grandes.

Compaction

Cuando una conversacion crece mucho, el contexto puede superar los limites del modelo. OpenCode maneja esto con compaction:

Auto-compaction

OpenCode compacta automaticamente el contexto cuando detecta que se acerca al limite de tokens. Resume los mensajes anteriores conservando la informacion esencial.

Configuracion

Configura las reservas de tokens para controlar cuando se dispara la compaction:

{
  "context": {
    "tokenReserve": 4096
  }
}

Compaction Manual

Si quieres compactar en cualquier momento:

/compact

Util cuando sabes que ya no necesitas el historial detallado de pasos anteriores y quieres liberar espacio en el contexto.

Watcher

OpenCode observa cambios en el filesystem para mantener el contexto actualizado. Configura patrones de ignore para evitar que reaccione a directorios ruidosos:

{
  "watcher": {
    "ignore": [
      "node_modules",
      ".git",
      "dist",
      "build",
      ".next",
      "__pycache__",
      "*.log"
    ]
  }
}

Sin esta configuracion, el watcher podria reaccionar a miles de cambios cuando instalas dependencias o compilas el proyecto.

Rules e Instructions

OpenCode lee automaticamente archivos de reglas que definen las convenciones del proyecto:

AGENTS.md

Crea un archivo AGENTS.md en la raiz del proyecto con instrucciones que OpenCode leera automaticamente:

# Reglas del Proyecto

- Usar TypeScript strict
- Tests con Vitest
- Commits en formato conventional commits
- Codigo en ingles, documentacion en español

Directorio de Reglas

Para reglas mas organizadas, usa el directorio .opencode/rules/:

.opencode/
  rules/
    general.md
    testing.md
    deployment.md

OpenCode lee todos los archivos .md del directorio de reglas y los incluye como contexto del sistema. Esto es mas mantenible que un solo archivo grande.

Modo No Interactivo

Ejecuta OpenCode sin la TUI para scripts y pipelines:

opencode run "genera tests unitarios para src/utils/math.ts"

El comando run ejecuta el prompt, imprime el resultado y termina. Ideal para:

• Scripts de CI/CD
• Pre-commit hooks
• Automatizacion con bash scripts
• Pipelines de procesamiento de codigo

Puedes combinarlo con pipes:

cat error.log | opencode run "analiza este log y sugiere fixes"

Checklist de Productividad

Configuraciones recomendadas para maximizar tu productividad con OpenCode:

• Configurar AGENTS.md con las convenciones y stack del proyecto
• Definir comandos custom para tareas repetitivas (deploy, test, lint)
• Configurar formatters para auto-formateo despues de cada edicion
• Usar Plan antes de Build para features complejas o multi-archivo
• Configurar MCP servers para las herramientas externas que usas (DB, APIs, docs)
• Monitorear costos con opencode stats regularmente
• Configurar watcher ignore para evitar ruido de node_modules y build artifacts
• Nombrar sesiones para poder retomarlas facilmente
• Configurar keybinds adaptados a tu flujo de trabajo
• Usar --continue para retomar sesiones entre reinicios

Resumen del Tutorial

A lo largo de 20 capitulos cubrimos OpenCode desde la instalacion basica hasta integraciones avanzadas:

• Fundamentos: instalacion, configuracion, primeros pasos con la TUI
• Agentes: built-in, custom, herramientas del sistema y custom tools
• Proveedores: cloud, modelos locales con Ollama, Zen Mode
• Extensibilidad: MCP, Skills, comandos custom, plugins
• Integraciones: GitHub Actions, LSP, formatters, IDE, ACP
• Avanzado: SDK, server mode, sessions, tips de productividad

OpenCode es una herramienta en constante evolucion. Consulta la documentacion oficial y el repositorio en GitHub para mantenerte al dia con las nuevas funcionalidades.

---

< Volver al Indice del Tutorial