El panel de VS Code

La extensión de VS Code (kbspec Cockpit) trae el ciclo al editor: el estado del expediente abierto, la fase actual, el consumo medido y los próximos pasos, sin salir a la terminal.

Como todo en kbspec, el panel invoca al CLI (kb … --json) y no reimplementa lógica: lo que ves en el panel es exactamente lo que kb reporta.

Instalar

code --install-extension ~/.kb/extension/kbspec-cockpit-*.vsix

/kb-instalar la ofrece como paso opcional durante la puesta a punto.

Una sola entrada en la barra de estado

Abajo a la izquierda queda una entrada: el ticket, la fase y las brechas. El clic abre un menú con todo lo demás —qué sigue, el ciclo, validar, la sesión y su contexto, el modelo, el presupuesto, la configuración y el diagnóstico—. El contexto, el modelo y el presupuesto aparecen por su cuenta solo cuando piden atención: el contexto pasó el umbral, el modelo no es el de la fase, el presupuesto está en aviso. Las pruebas, mientras corren. Para tenerlos siempre a la vista: kbspec.barraDeEstado: "completa", o el último renglón del menú.

«Te toca»: todos los requerimientos abiertos

Con varios requerimientos abiertos a la vez —en esta ventana, en otra o en una carpeta paralela—, la primera vista del panel los junta y los agrupa por lo que espera cada uno:

Grupo	Por ejemplo
Espera tu decisión	«aprobado 02», autorizar el lote, la E06, el PR
PR con observaciones	cambios solicitados, la ronda de G-Bot
Trabado	una tarea del lote fallida, un P0 sin resolver, una pregunta abierta
El lote está corriendo	cuántas tareas van integradas
Listo para el PR	las pruebas listas y sin PR
En curso	lo que frena la fase, o cuántas tareas van cerradas

El grupo lo decide la CLI —kb bandeja --json, que solo lee archivos— y cada requerimiento cae en uno solo. El ícono de kbspec muestra cuántos esperan una decisión tuya. Clic en uno y vas a su ventana; el ojo muestra su detalle al costado sin cambiar la sesión de esta ventana; clic derecho para posponerlo o fijarlo arriba, que es de cada persona y no viaja en el expediente.

Empezar trabajo

El cohete de la bandeja y de la lista: retomar un requerimiento que ya existe o empezar uno nuevo, en un solo recorrido. Para retomar se elige cuál y dónde —esta ventana (kb abrir), su propia ventana (kb abrir --otra-ventana) o una carpeta aparte en paralelo (kb paralelo)—. Para uno nuevo, el ticket, el título y el tamaño, y el pedido queda escrito en el chat para que lo mandes vos. Antes de hacer nada, dice qué va a hacer.

Las pruebas en el Test Explorer

La vista de Testing de VS Code muestra cada caso del plan (06) con lo que dijo el runner —o el 07, si no corrió—, en orden y con su prioridad, y cada paso por app (compilar, lint, unitarias, API, E2E, scripts de BD) con la salida del comando. Clic en un caso lleva a su definición en el 06; uno en rojo trae el mensaje. Correr manda kb pruebas --solo <suite> a la terminal y los resultados aparecen solos al terminar. Sale de kb pruebas resultados --json, que con --json no escribe el 07.

G-Bot, la revisión y DBA, en su línea

Los issues de la última ronda de G-Bot, los hallazgos abiertos de la revisión y las observaciones de DBA sin responder aparecen como comentarios en el código, en su línea, y también en Problemas con su propia fuente. Lo que escribís en el hilo es la justificación:

Aplica / No aplica corre kb pr gbot decidir —publicar la respuesta en el PR sigue siendo otro paso—;
Corregido / Descartar corre kb revisar --cerrar / --descartar;
Responder deja la respuesta a DBA escrita en el chat.

Sale de kb comentarios --json. Se apaga con kbspec.comentariosEnElCodigo.

Cerca del código

Correcciones rápidas sobre las brechas. El foco amarillo sobre «RF-05 no aparece en 06» ofrece pedirle al agente que la cubra —sin inventar contenido— o ir a donde se define.
El mensaje del commit, armado. Con una tarea en curso, el cuadro de Source Control de los repositorios de código arranca con REQ-… T-03: . Lo que ya escribiste no se pisa.
Enlaces en la terminal. Los T-NN, RF-NN y CP-NN del expediente y el ticket llevan a su definición o al ciclo.
Marcas del Explorador. Los documentos aprobados llevan ✓, los vencidos !, y los archivos que la rama tocó sin que el análisis (03) los declare, Δ.
El lote, tarea por tarea, y el visto bueno de DBA, en el árbol del expediente.
El proyecto SQL desde Repos y PRs: la vista previa de kb sqlproj y aplicar con confirmación.
El servidor MCP de kbspec, donde falta. El árbol que la ventana de agentes arma para cada sesión no trae el .vscode/mcp.json: el panel lo registra con la API de VS Code solo donde no está declarado y la política lo deja (kb mcp --registro --json).

Las respuestas de `@kb`, como herramientas del agente

VS Code declaró obsoletos los participantes de chat: no corren en el arnés de Copilot. Las respuestas de @kb están también como herramientas que el agente usa solo o que nombrás con #: #kbspec_estado, #kbspec_que_sigue, #kbspec_que_falta_pr, #kbspec_aprobaciones y #kbspec_consumo. Salen del mismo lugar y no llaman a ningún modelo. @kb sigue mientras el arnés local lo acepte.

El recorrido «kbspec: primeros pasos» (Ayuda → Primeros pasos) lleva de cero al primer requerimiento en cuatro pasos.

La sesión en vivo

Lo que OpenCode muestra al costado de la terminal, en VS Code. En el menú de la barra de estado —y en la barra misma cuando pide atención—, Contexto 187 k · 94 % · 45 cr: el contexto de la última llamada al modelo, el porcentaje de la ventana del modelo y los créditos que Copilot facturó por esta conversación —la del chat de VS Code o la de la ventana de agentes, la que trabajó más recién—. Amarillo desde el 60 % de la ventana, rojo desde el 85 %; un clic abre un chat nuevo. En el panel, la sección Sesión agrega las herramientas contra el tope de 100, el modelo actual contra la clase que la fase pide, el MCP de kbspec, la rama y la versión. Se relee sola cada vez que Copilot escribe una llamada nueva en su base de trazas; kb tokens --vivo muestra lo mismo en la terminal.

El costo, siempre con su base. En el árbol, la sección «Consumo», el tablero del equipo y @kb /consumo: US$ 1.68 · 168 créditos facturados cuando es lo que Copilot cobró; ≈US$ 2.68 · ≈268 créditos (168 facturados + ≈100 estimados) cuando una parte no trae lo facturado; ≈US$ 16.80 · ≈1680 créditos (estimado por tarifa) cuando nada lo trae. Lo estimado lleva ≈ y nunca se presenta como lo cobrado, y los créditos no se abrevian ni llevan separador de miles.

Al cruzar el umbral aparece el aviso con Seguir en un chat nuevo y Compactar.

El chat nuevo se abre solo

Cuando el expediente registra una tarea cerrada o un cambio de fase, la extensión exporta el chat actual al expediente (evidencias/chats/, con modelo, tokens y créditos por pedido; un chat sin pedidos no se guarda) y abre una conversación nueva con el agente de la fase, el siguiente paso ya escrito y el modelo que MODELOS.md pide para esa fase. Por defecto el mensaje queda escrito y el desarrollador lo manda con Enter; nunca se arranca código sin que lo pida. Por qué importa está en Menos tokens.

Configurar conversando

La pestaña Puesta a punto abre con lo que falta para poder empezar un requerimiento y tres botones que abren un chat nuevo con /kb-configurar en su modo: Configurar kbspec (el recorrido completo), Configurar una app (una que ya tiene código) y App nueva (una aplicación, módulo o componente que todavía no existe). La vista de aplicaciones los tiene en su barra, junto con Preguntar cómo funciona una aplicación, y si el inventario está vacío invita a configurarlo. Está en Configurar conversando.

La lista de requerimientos

En Todos los requerimientos, cada uno dice su fase, quién lo trabajó y cuándo se movió por última vez —de la bitácora de auditoría del expediente—. Con el tiempo son cientos, así que se ven los más recientes (15, el ajuste kbspec.listaRecientes; el abierto, siempre) y «Mostrar todos» despliega el resto. La lupa de la barra busca en todos por ticket, título, aplicación, fase o persona.

Un clic no abre nada sin avisar. Primero explica qué hace y pide confirmación; si en la ventana ya hay otro requerimiento abierto, ofrece abrirlo en otra ventana —el de acá sigue intacto y no se crea ninguna rama— o cerrar el de acá y abrirlo. Para no confirmar cuando la ventana está libre: kbspec.confirmarAlAbrir.

El tablero del equipo

Las fases en columnas, una tarjeta por requerimiento con lo que lo traba y lo que costó.

Abre en el mes de hoy. El año y los meses se eligen arriba —varios meses del mismo año, si querés ver un trimestre—, y cada mes dice cuántos tuvieron actividad. «+ Mes anterior» suma el de antes (de enero pasa a diciembre del año anterior); «Todo el año» y «Sin filtro de fecha» abren el rango. Un requerimiento está en un mes si tuvo cualquier movimiento en su bitácora ese mes: lo que sigue abierto aparece en cada mes en que se trabajó. El costo es el total del requerimiento, no el del período.
Un clic en una tarjeta muestra su detalle al costado: fechas de solicitud, inicio, último movimiento y entrega; responsable, solicitante y quiénes lo trabajaron; el avance en fases, tareas y documentos; el bloqueo, la aplicación, el pase, el sprint y el costo.
Abrirlo es un botón del detalle, y siempre pide confirmación explicando qué va a pasar —también con la ventana libre—. Mirar una tarjeta nunca cambia la sesión.

El mapa de las aplicaciones

En Configuración de kbspec → Mapa, cada aplicación de negocio es un diagrama de arquitectura dibujado desde el inventario: la aplicación, sus módulos y lo que usan, en capas. Cada componente queda a la derecha de quien lo usa, así que la cadena se lee de izquierda a derecha —aplicación → módulo → API → base de datos—. Los módulos van agrupados por repositorio y los componentes por su tipo, cada clase con su ícono y su color.

Un clic en un nodo resalta su cadena entera: lo que usa, quién lo usa y lo que depende de él indirectamente. Una tarjeta muestra cuántos se verían afectados si cambia, la lista de cada lado y los botones para abrir su ficha o editarlo en el inventario.
Un clic en un grupo o en una clase de la leyenda resalta todos sus integrantes y sus conexiones hacia afuera.
Flujo / Quieto prende o apaga el movimiento que muestra en qué sentido se usa cada conexión; con el sistema en «reducir movimiento», no se anima nada.
Zoom con los botones o con Ctrl/Cmd y la rueda; ajustar lo deja entero en la ventana; arrastrando el fondo se recorre. Esc limpia la selección.

Las flechas salen de la columna Consume del inventario; un componente que nadie declara consumir se conecta a la aplicación con una línea punteada. Se afina con kb apps editar <MÓDULO> --consume "<COD>, <COD>".

Los modelos que ofrece esta máquina

Al arrancar, la extensión anota en ~/.kb/modelos-copilot.json la lista real de modelos que VS Code ofrece. Con eso kb init y kb modelo --validar avisan cuando un nombre de MODELOS.md está publicado pero no disponible acá.

Ajustes

Ajuste	Por defecto	Qué controla
`kbspec.chatNuevo`	`prellenado`	`automatico` manda el mensaje solo; `nunca` no abre chats
`kbspec.avisoContextoPct`	`60`	Desde qué % de la ventana la barra avisa (0 apaga)
`kbspec.topeTurnos`	`100`	Cada cuántas llamadas del agente a una herramienta ofrecer el chat nuevo
`kbspec.exportarChat`	`true`	Guardar el chat anterior en el expediente
`kbspec.seguirEnVivo`	`false`	Abrir solo el documento que el agente escribe. Apagado, el agente nombra en el chat, con un enlace, los documentos que cambió
`kbspec.diagnosticos`	`true`	Las brechas de trazabilidad en el editor y en Problemas
`kbspec.barraDeEstado`	`compacta`	Una sola entrada en la barra (`compacta`) o los indicadores de siempre (`completa`)
`kbspec.comentariosEnElCodigo`	`true`	G-Bot, la revisión y DBA como comentarios en su línea del código