Descarga gratis

Terminal, Archivos y Cambios

Los paneles para ver la terminal del chat, sus archivos y las diferencias que hizo el agente.

Actualizado el · versión 2.0.317 · Markdown

El panel de la derecha tiene tres herramientas para programar: «Terminal», «Archivos» y «Cambios».

Abrir un panel

  1. En la barra de título, pulsa «Terminal», «Archivos» o «Cambios».
  2. El panel se abre a la derecha. ⌘\ lo abre o cierra.

Terminal

Tu propia terminal en la carpeta del chat, como la app Terminal del Mac: escribe ahí tus comandos. Es solo tuya: los agentes no la usan ni leen lo que imprime. Cuando pulsas «Actualizar ahora», tus terminales y lo que corre en ellas (un servidor, una compilación) siguen corriendo durante la actualización, salvo que tengan archivos que la actualización debe reemplazar; entonces terminan, como al salir de la app. Un enlace en la salida se abre con un clic.

Cuando un comando pide una contraseña o una confirmación (ssh, sudo o git), la app te muestra una tarjeta, «Un comando pide tu contraseña», con «Enviar» y «Cancelar». Lo que respondas va solo a ese programa: ningún agente lo ve.

Archivos

«Archivos del chat»: los archivos con los que trabajó el chat. Ábrelos para leerlos.

«Para borrar»: lo que borran los agentes

Un agente no borra tus archivos: los aparta. Lo que borra con sus comandos (rm, rmdir, unlink, trash, o mv cuando escribe encima de otro archivo) o con sus herramientas de archivos va a una carpeta llamada «Para borrar» («To delete» si tu app está en inglés), arriba de la carpeta del chat. Vale en todos los niveles de permiso, también con «Acceso completo».

  • Cada cosa queda en el mismo lugar que tenía dentro de la carpeta: «Para borrar/src/viejo.swift». Si ese nombre ya está, se le añade un número.
  • Lo que borra fuera de la carpeta del chat va a la «Para borrar» de su carpeta de trabajo, con su ruta completa.
  • El agente te dice adónde fue cada cosa, y la app anota de dónde vino, qué chat la mandó y cuándo.

La papelera de la barra de título

Arriba a la derecha, en la barra de título, el primer ícono es una papelera («Para borrar: lo que borraron los agentes»). Mientras hay cosas esperando, lleva un número con cuántas son. Muestra lo del chat que tienes en pantalla.

  1. Pulsa la papelera. Se abre «Para borrar»: «Lo que borraron los agentes espera aquí por si lo quieres de vuelta. Devuelve lo que necesites y borra el resto.»
  2. Cada fila dice qué es, de dónde vino («De …») y quién la mandó y cuándo. Tiene tres botones:
    • «Devolverlo a donde estaba»: vuelve a su sitio y te dice «… volvió a donde estaba.». Si ahí ya hay algo con ese nombre, no lo pisa: te lo dice y lo deja donde está.
    • «Mostrarlo en Finder».
    • «Borrarlo: se va a la Papelera»: confírmalo con «Borrar», en el mismo lugar.
  3. Abajo, «Vaciar todo: lo que está en tu perfil cifrado se borra para siempre; lo demás va a la Papelera». Al pulsarlo, la app primero te muestra cada cosa que se iría, medida en ese momento, con su nombre, dónde está, su tamaño y qué le pasa, con la cuenta y el total exactos: «Borrar para siempre: … elementos, hasta …, de tu perfil.» y «A la Papelera: … elementos, …». Lo que un «Vaciar todo» anterior dejó sin terminar en la papelera propia de tu perfil también aparece, en un grupo aparte. Confírmalo con «Vaciar todo». Cuando algo se borra para siempre, aparece una segunda pregunta arriba de la ventana, con «Cancelar» elegido: «Esto no se puede deshacer: … elementos de tu perfil se borran para siempre, hasta ….»; confírmalo con «Borrar para siempre». Un clic o una tecla que empezó antes de que apareciera esa pregunta no cuenta, y pulsar Retorno o Espacio sin pasar a «Borrar para siempre» no confirma. Después te dice qué pasó: «… elementos se borraron para siempre: hasta … queda libre otra vez dentro de tu perfil.», y cuándo recupera ese espacio el disco de tu Mac (la app compacta el perfil al abrirlo). Si algo cambió entre lo que viste y el borrado, no se borra nada: te muestra la lista nueva y vuelves a confirmar desde el principio. Si se detiene a mitad, te dice dónde y por qué, con el código del sistema, y qué sigue en «Para borrar». Lo que apunta fuera de tu perfil, como un enlace a otro lugar, se queda como está, sin borrarse ni seguirse, y la app te lo dice. Fuera de tu perfil solo se van a la Papelera las cosas de la lista; la carpeta «Para borrar» se queda.

Si no hay nada, dice «No hay nada. Cuando un agente borra algo, llega aquí primero.». Lo que se va a la Papelera del Mac todavía lo puedes sacar de allí; lo que se borra para siempre no vuelve. En «Archivos», la carpeta «Para borrar» también se ve entera.

Solo tú borras de ahí: ningún agente, ni tu teléfono, ni un canal pueden borrar ni vaciar «Para borrar»; solo tu clic en la ventana de la app. Los agentes tampoco pueden vaciar la Papelera del Mac.

Lo que borraría para siempre sin pasar por «Para borrar» no se hace, en ningún nivel y sin tarjeta: el agente lee por qué y usa la forma que guarda los archivos. Por ejemplo rm llamado por su ruta (/bin/rm) o con sudo, find -delete, git clean, git rm, los borrados de rsync, shred o vaciar la Papelera.

Ordena o mueve tus archivos

Pídele a Breini o a un Nobreinier que ordene una carpeta o que mueva unos archivos, y nada se mueve antes de que veas el plan. Puede ordenar los archivos de una carpeta por tipo (imágenes, documentos, hojas de cálculo y demás), por el mes de la fecha del archivo o por extensión, o mover los elementos que nombres a las carpetas que nombres. Nunca escribe encima y nunca borra: un nombre ya ocupado en el destino se deja donde está y se avisa, y un archivo que el navegador todavía está descargando se deja quieto.

  1. Una tarjeta muestra el plan: qué carpeta, cuántos archivos se moverán y a qué carpetas. Si un nombre está ocupado, la tarjeta lo lista en «No se mueven, el nombre ya está ocupado allí». Cada vez se mueven 500 elementos como máximo; si hay más, el plan dice cuántos esperan a la próxima vez.
  2. Apruébalo. En «Acceso total» la tarjeta del plan no se muestra y el movimiento se hace en el acto.
  3. Cuando termina, una tarjeta dice qué se ordenó, cuántos archivos se movieron y a qué carpetas, con «Deshacer todo». Un clic en «Deshacer todo» devuelve cada archivo a su sitio. Un archivo que cambió desde entonces, o cuyo sitio de antes está ocupado, se queda como está y la tarjeta lo lista.

La tarjeta antes de que algo vaya a «Para borrar»

Cuando un agente quiere borrar archivos, la tarjeta de aprobación dice «A borrar: …» y qué, y añade que no se borra nada: va a la carpeta «Para borrar» al inicio de su proyecto, y puedes recuperarlo desde ahí. Tu sí está en esa tarjeta. La carpeta y la papelera se describen arriba.

Cómo lee, busca y edita tu agente tus archivos

  • Buscar: si un patrón de búsqueda no termina nunca en un archivo, detener al agente lo para dentro de ese archivo, y pasados 5 segundos ese archivo se deja. El agente sabe qué archivos se dejaron, así que nunca toma los resultados como completos.
  • Líneas muy largas: una línea de más de 2.000 caracteres se muestra cortada, con dónde seguir; el agente lee el resto por partes, hasta el final.
  • Guardado sin cambios: antes de editar un archivo, el agente comprueba que sigue siendo el que leyó. Si el archivo se guardó de nuevo con el mismo contenido (lo guardó un editor, lo tocó una herramienta), la edición sigue; si el contenido cambió, el agente lo lee otra vez primero.

Archivos que hizo tu agente

Cuando un turno crea documentos (un PDF, una hoja de cálculo, una presentación u otro archivo fuera del código del proyecto) y la respuesta no los nombra, una tarjeta bajo la respuesta los lista. Cada uno tiene «Abrir» y «Mostrar en Finder». La tarjeta sigue ahí cuando abres el chat más tarde; en un chat largo que se resumió, las tarjetas más viejas ya no se ven. Los archivos del código del proyecto se ven en «Cambios».

Cambios

La tarjeta de un turno lista los archivos que cambió; con dos o más, «Guardar todo en un zip» los guarda como están ahora en un zip (un archivo que ya no está se deja fuera y se nombra).

  1. «Cambios del chat» muestra cada archivo cambiado y sus «Cambios del archivo».
  2. En «Qué cambios ver», elige «Sin confirmar», «Toda la rama», «Commits de la rama» o «Último turno». «Toda la rama» y «Commits de la rama» empiezan donde nació la rama: la app lo encuentra sola (muestra, por ejemplo, «Desde main (automático)») y puedes elegir otro punto con «Comparar con», que lista tus ramas y commits. «Último turno» muestra lo que el agente cambió en su última respuesta, aunque no tengas commits.
  3. Pulsa «Revisar» y el agente revisa estos cambios como un revisor exigente, sin tocar nada. Para una revisión a fondo, mira Revisión de código.
  4. Para volver un archivo atrás, mira Volver atrás y deshacer archivos.

La lista viene ordenada por tipo de archivo: «Código», «Pruebas», «Configuración», «Documentos», «Generados», «Recursos» y «Otros». Así ves primero lo que importa.

Cuando un bloque de código solo cambió de lugar, la app lo marca en vez de mostrarlo como borrado y añadido: «… líneas movidas desde …» o «… líneas movidas a …».

Lleva la cuenta de lo que ya leíste

  • Pulsa «Marcar como revisado» en un archivo cuando hayas leído su cambio. La lista atenúa los archivos leídos y los cuenta («3 de 12 revisados»). Si el archivo vuelve a cambiar, la marca se quita sola, así nunca das por bueno un cambio que no viste.
  • Pulsa «Lado a lado» para ver cada cambio en dos columnas: lo quitado a la izquierda y lo añadido a la derecha. La app recuerda tu elección. En un panel angosto se queda en una columna.
  • Una imagen cambiada muestra «Antes» y «Después» una junto a otra; una nueva o eliminada muestra «Imagen nueva» o «Imagen eliminada».

Imágenes, sonidos y videos

Una imagen, un sonido o un video del panel se abre en un visor. Los archivos de cualquier tamaño se abren al instante: la app los lee de tu disco mientras miras, no los carga enteros. En una imagen, pellizca o pulsa más y menos para «Acercar» y «Alejar», arrastra o usa las flechas para moverla, pulsa 0 para «Ajustar a la vista» y 1 para «Tamaño real». «Vista grande» le da a un video todo el panel y «Volver a los cambios» regresa. Si un archivo no se puede reproducir aquí, el visor lo dice y puedes mostrarlo en Finder.

Código para consultar: el código de otros proyectos

Cuando un agente necesita saber cómo funciona de verdad una librería, es mejor que lea el código de la propia librería a que adivine. En «Ajustes» › «Almacenamiento», la sección «Código para consultar» guarda en tu Mac, con un nombre, el código de otros proyectos:

  1. Pega la dirección de un repositorio de código público (por ejemplo, el de una librería que uses) y pulsa «Guardarlo aquí».
  2. La copia se actualiza sola cada día. Pulsa «Buscar novedades ahora» para actualizarla al momento.
  3. Breini y los Nobreiniers la leen cuando la necesitan. Solo se lee: nada de lo que hay dentro se ejecuta jamás.
  4. Para quitar una, pulsa «Mover a la Papelera».

Junto a cada una ves de dónde viene, cuánto espacio ocupa y cuándo se revisó por última vez. Tus archivos y tus ajustes nunca forman parte de estas copias.

Herramientas de código para tus lenguajes

Para encontrar con exactitud dónde está cada cosa y detectar errores mientras escribe, el agente usa una pequeña herramienta para cada lenguaje. Si tu proyecto necesita una que falta, el agente te pregunta una vez con una tarjeta: «… quiere instalar una herramienta para entender código de …». Pulsa «Permitir siempre» y se instala en segundo plano con un programa que ya tienes en tu Mac (puedes seguir trabajando), y la app recuerda tu respuesta para ese lenguaje; pulsa «Ahora no» y no se instala nada, y no se vuelve a ofrecer a menos que lo pidas. Cuando está lista, el chat te lo dice: «la herramienta para el código quedó instalada y lista». La app guarda una lista de lo que instaló, y el agente puede quitarla después detrás de su propia tarjeta.

Ordenar el código cuando el agente termina

En los ajustes de un proyecto, el interruptor «Ordenar el código con el formateador del proyecto cuando un agente termina» ejecuta el formateador que el proyecto ya tiene, una vez por respuesta, en los archivos que cambió el agente. Nunca instala un formateador propio. También puedes pedírselo a Breini con tus palabras.

Una copia de trabajo nueva recibe tu preparación

Cuando un agente trabaja en su propia copia de trabajo (un worktree de git nuevo), la app ejecuta tus ganchos «Setup» justo después de crearla, para que la copia empiece con lo que necesita. Si uno falla, la copia se crea igual y te dice qué preparación falló. Mira Ganchos.

Comando

Cuando el agente lanza un comando largo, el panel «Comando» muestra su salida mientras corre y cómo terminó: «Corriendo», «Terminó», «Falló» o «Detenido». Se abre solo; mira Un paso adelante.

Cuando el agente deja un comando largo corriendo de fondo y lo espera, la espera termina con una respuesta clara: terminó, espera que escribas algo, se quedó callado o sigue corriendo. El agente deja de preguntar una y otra vez: cuando un comando espera una respuesta, la app se lo dice una vez. Un comando que solo imprime durante mucho tiempo, como un servidor, no despierta al agente por sí solo.