Capitulo 16: Task Table
Capitulo 16: Task Table
< Volver al Indice del Tutorial
Panel de tareas en tiempo real
Spacecake incluye un panel de tareas que muestra las tareas de Claude Code en tiempo real. Mientras Claude trabaja, puedes ver el progreso de cada paso sin interrumpir su flujo.
Que son las tareas de Claude Code
Cuando Claude Code trabaja en tareas complejas, usa internamente las herramientas TodoWrite y TodoRead para crear y gestionar una lista de tareas. Estas tareas representan los pasos individuales que Claude planifica y ejecuta.
Las tareas se almacenan como archivos en el directorio ~/.claude/tasks/. Cada archivo contiene la informacion de una lista de tareas en formato JSON.
Task Table en Spacecake
Spacecake visualiza estas tareas en una tabla estructurada dentro del panel lateral. La tabla muestra columnas con el estado y los detalles de cada tarea, organizados de forma clara.
Requisitos
Para que la task table funcione, necesitas una sesion activa de Claude Code conectada a Spacecake. Si no hay ninguna sesion conectada, el panel muestra el mensaje “no active claude session”.
Una vez que conectas Claude Code (como se explico en el capitulo 12), la task table se activa automaticamente.
Datos mostrados por tarea
Cada fila de la tabla muestra la siguiente informacion:
Estado
El estado actual de la tarea, que puede ser:
- Pendiente: la tarea esta en la lista pero Claude aun no ha empezado a trabajar en ella.
- En progreso: Claude esta trabajando activamente en esta tarea.
- Completada: Claude termino la tarea exitosamente.
Los estados se representan visualmente con indicadores de color para identificarlos de un vistazo.
Descripcion
El texto descriptivo de la tarea tal como Claude la definio. Incluye el detalle de que se necesita hacer o que se logro.
Seguimiento en tiempo real
El panel se actualiza automaticamente cuando Claude crea, actualiza o completa tareas. No necesitas refrescar ni hacer click en ningun boton.
Spacecake implementa file watching sobre el directorio de tareas de Claude Code. Cuando detecta un cambio en los archivos de tareas, lee los datos actualizados y refresca la tabla.
Esto significa que puedes mantener el panel visible mientras Claude trabaja y ver como las tareas pasan de “pendiente” a “en progreso” a “completada” en tiempo real.
Virtualizacion de la tabla
La tabla usa virtualizacion para manejar listas grandes de tareas sin problemas de rendimiento. Solo las filas visibles en pantalla se renderizan en el DOM, lo que mantiene la interfaz fluida incluso cuando Claude genera decenas de tareas.
Puedes hacer scroll por la lista sin experimentar lag o demoras en la actualizacion visual.
Relacion con TodoWrite y TodoRead
TodoWrite y TodoRead son los tools internos que Claude Code usa para gestionar su lista de tareas. Son parte del sistema de herramientas de Claude y funcionan de forma transparente.
- TodoWrite: Claude usa esta herramienta para crear nuevas tareas, actualizar su estado o marcarlas como completadas.
- TodoRead: Claude usa esta herramienta para leer el estado actual de sus tareas y decidir que hacer a continuacion.
Spacecake simplemente lee y visualiza los archivos que Claude genera con estas herramientas. No interfiere con el flujo interno de Claude ni modifica las tareas directamente.
Uso practico
La task table es mas util cuando Claude trabaja en proyectos grandes con multiples pasos. Algunos escenarios donde brilla:
- Refactorizaciones: Claude crea tareas para cada archivo o modulo a refactorizar. Puedes ver el progreso general.
- Implementacion de features: Claude descompone la feature en pasos y puedes verificar que no se salte ninguno.
- Debugging: Claude puede crear tareas para cada hipotesis que investiga, dando visibilidad sobre su proceso de razonamiento.
La ventaja principal es que puedes monitorear el progreso sin interrumpir a Claude. No necesitas preguntarle “en que paso vas” porque la informacion esta visible en el panel.
Configuracion del ID de lista
El ID de la lista de tareas se puede configurar via la variable de entorno CLAUDE_CODE_TASK_LIST_ID. Esto es util si tienes multiples listas de tareas y quieres que Spacecake muestre una especifica.
Si no configuras esta variable, Spacecake usa la lista de tareas activa de la sesion conectada.
Siguiente: Capitulo 17: Panel Git —>