Esta carpeta explica cómo funciona opencode-subagent-statusline: qué problema resuelve, cómo se integra con OpenCode, cómo procesa eventos de subagentes y cómo se mantiene el proyecto.
La documentación está pensada para dos públicos:
- Usuarios del plugin, que quieren instalarlo, configurarlo y entender qué están viendo en la TUI.
- Contribuidores, que necesitan entender la arquitectura, los tests y las reglas internas antes de cambiar código.
Si es tu primera vez en el repo, seguí este orden:
- Visión general
- Instalación y uso
- Arquitectura
- Flujo de eventos
- Modelo de estado y contadores
- Renderizado y deduplicación
- Interfaz TUI
- Configuración avanzada
- Desarrollo y testing
- Solución de problemas
| Documento | Para qué sirve |
|---|---|
| 01-vision-general.md | Entender qué hace el plugin y cuáles son sus piezas principales. |
| 02-instalacion-y-uso.md | Instalar el plugin en OpenCode y usar la sidebar. |
| 03-arquitectura.md | Entender los módulos del código y cómo se conectan. |
| 04-flujo-de-eventos.md | Seguir el camino desde un evento de OpenCode hasta una fila visible. |
| 05-modelo-de-estado-y-contadores.md | Explicar StatuslineState, ChildSessionState, sources y totalExecuted. |
| 06-renderizado-y-deduplicacion.md | Explicar collapse de filas, visibilidad y diferencias entre estado interno y UI. |
| 07-interfaz-tui.md | Documentar sidebar, footer, navegación y comandos. |
| 08-configuracion-avanzada.md | Variables de entorno, archivos de estado, debug y rutas. |
| 09-desarrollo-y-testing.md | Comandos, estrategia de tests, límites de cobertura y smoke tests. |
| 10-solucion-de-problemas.md | Casos comunes: plugin no aparece, cache vieja, tokens faltantes, etc. |
Documentos creados:
00-indice.md01-vision-general.md02-instalacion-y-uso.md03-arquitectura.md04-flujo-de-eventos.md05-modelo-de-estado-y-contadores.md06-renderizado-y-deduplicacion.md07-interfaz-tui.md08-configuracion-avanzada.md09-desarrollo-y-testing.md10-solucion-de-problemas.md
No forma parte de la numeración actual:
- publicación y release, que queda como tema pendiente si se decide documentarlo después.