Cómo trabajar con el agente en Vecipp CLI

(Categoría: Vecipp IA)

¿Qué es y para qué sirve?

Es el día a día con el agente: le escribes lo que necesitas en el cuadro de abajo, él trabaja en tu proyecto y tú ves en pantalla todo lo que hace —lo que lee, lo que cambia, los comandos que corre y lo que piensa— hasta que te entrega el resultado y cómo lo comprobó.

¿En qué te beneficia?

• Delegas trabajo real: arreglar errores, crear funciones, revisar un servidor o una base de datos.
• Nunca pierdes el control: antes de cambiar archivos te pregunta, y puedes interrumpirlo con Esc en cualquier momento.
• Trabaja con método: lee lo necesario, corre las pruebas antes de tocar nada, arregla, vuelve a probar y te dice cómo lo verificó.
• Sabes en qué va: su plan aparece arriba con la tarea en la que está, y se marca cuando de verdad la termina.

¿Cómo funciona?

La pantalla. Abajo está el cuadro de texto (empieza con >); debajo, el modelo, el esfuerzo de razonamiento y el modo. Arriba va la conversación, cada línea con su símbolo a la izquierda y el texto alineado:

• → tu mensaje, en una franja gris con la hora.
• 𓄃 lo que te responde el agente.
• 𓄀 Thought for 3s ▸ lo que pensó antes de actuar: tócalo para leerlo entero.
• ✓ un paso que salió bien y ✗ uno que falló. Leer, buscar y ejecutar se juntan en una línea gris («Read 3 files, ran 1 shell command») que se abre con un clic.
• Cada cambio a un archivo sale entero: en verde lo nuevo, en rojo lo que quita. Si lo cambia con un comando, ves «Updated archivo +N -N».
• ⏻ avisos y ⚠ avisos importantes.
• ⌬ el cierre de cada turno, con cuánto tardó.

Mientras trabaja ves el logo de Vecipp (▲▼) moviéndose con un verbo («Forging…») y, debajo, lo que hace en ese momento. Si tiene un plan, va encima: ▴ Plan 3/8 · la tarea en la que va ▸; tócalo para ver todas las tareas. Al terminar, el plan se quita.

Los modos (se cambian con Shift+Tab): normal te pregunta antes de cada cambio; ✎ edits acepta solas las ediciones de archivos; # root hace todo sin preguntar (en rojo, para que lo notes); ◷ plan solo lee y te presenta un plan para que lo apruebes. Aun en modo automático, siempre pregunta antes de algo destructivo (borrar carpetas enteras, reescribir el historial de git) o de escribir fuera de tu proyecto.

Videotutorial de Aprendizaje

¿Qué aprenderás en esta guía?

A pedirle trabajo al agente, aprobar o rechazar sus cambios, seguir su plan y su razonamiento, corregir el rumbo sin detenerlo y retomar una conversación.

Paso a paso para usar la función

1. Pide lo que necesitas en el cuadro de abajo, con contexto: qué pasa, qué esperas y, si hay un error, el mensaje completo. Pulsa Enter.
2. Aprueba sus cambios: cuando quiera cambiar un archivo o correr un comando, te muestra el cambio y te pregunta. Elige sí, sí a todas las ediciones de la sesión o no (y dile qué hacer en su lugar).
3. Corrige el rumbo sin pararlo: si mientras trabaja se te ocurre algo, escríbelo y pulsa Enter; se lo suma a lo que está haciendo.
4. Mira lo que piensa: toca la barra del verbo (o Alt+T) para ver su razonamiento en vivo.
5. Sigue el plan: toca ▴ Plan para ver todas las tareas; la que lleva el logo animado es la que está haciendo ahora.
6. Interrúmpelo con Esc si va por mal camino. Si lo mandaste por error y aún no respondió, Ctrl+C te devuelve el mensaje para corregirlo.
7. Lee la entrega: al terminar te dice qué hizo, cómo lo comprobó y qué falta.
8. Retoma después: al salir te deja el comando vecipp -s <id>; también vecipp --continue abre la última conversación de esa carpeta, y /resume te deja elegir cualquiera.

Errores comunes y cómo solucionarlos

• «Plan check: 2 tasks still open»: el agente iba a terminar con tareas abiertas en su plan; Vecipp le pide que lo deje como de verdad quedó antes de responder. Es normal y no tienes que hacer nada.
• «Proof check» o «Verify check»: dijo que algo funcionaba sin haberlo probado, o un test falló y no lo vio pasar; Vecipp le pide comprobarlo. Es para que no te entregue algo sin verificar.
• El modelo dejó de responder o está lento: si es un modelo gratis saturado, Vecipp prueba otro y te lo dice en un aviso. También puedes cambiarlo con /model.
• Se llenó el contexto: con conversaciones muy largas, /compact la resume para seguir; /handoff deja una nota para continuar en una conversación nueva.
• Hizo un cambio que no querías: /rewind deshace los cambios del agente hasta antes de un turno.

Qué no hace todavía

• La app de escritorio y Telegram todavía no muestran el plan plegado ni lo que cambia un comando, como la CLI.
• No recuerda entre conversaciones lo que no esté escrito en las reglas del proyecto (VECIPP.md) o en tu memoria del equipo: para algo permanente, agrégalo con # texto.
• Ningún modelo es perfecto: revisa los cambios importantes antes de publicarlos.