Código, Git y archivos

Abre el menú de worktrees y elige Nuevo worktree. Describe en qué vas a trabajar; Deska propone un nombre de rama y añade un número si ya existe. Abre Rama para editarlo. Detalles explica qué se copia, cómo se ejecuta la preparación y dónde se crea la carpeta. Empezar desde selecciona la rama cuyo último commit se copiará. Los cambios sin commit permanecen en la copia original. Empezar de cero abre una terminal; Copiar los paneles actuales indica el origen y copia solo los paneles principales compatibles, sin chats, lienzos anidados ni pestañas adicionales. Preparar el proyecto muestra el comando detectado antes de ejecutarlo en una terminal nueva. Crear y abrir abre el nuevo worktree. No se inicia ningún agente automáticamente.

Checks reúne el título de la solicitud y sus ramas sobre los resultados. Los fallos aparecen primero; la acción de merge y su motivo de bloqueo siguen a los resultados, con la conversación debajo. Explorador, Control de código y Checks comparten la misma tarjeta sin carpeta, icono y acción Abrir carpeta. Los estados vacíos agrupan la explicación y la siguiente acción, y la primera consulta muestra una estructura de carga. En paneles estrechos, los nombres y estados se ajustan sin ocultar acciones.

El panel de editor está construido sobre Monaco, el mismo editor que impulsa VS Code, con un árbol de archivos a la izquierda y una barra de pestañas en la parte superior. Haz clic en un archivo del árbol para abrirlo; las pestañas muestran un punto cuando hay cambios sin guardar.

Ampliar captura

• Pestañas de vista previa vs. fijadas: un solo clic abre un archivo en una pestaña temporal (en cursiva) de vista previa; haz doble clic para fijarla. El árbol mantiene seleccionado el archivo abierto y se desplaza hasta él al cambiar de pestaña.
• Cambiar el ancho de la barra lateral: arrastra su borde derecho para hacerla más ancha o más angosta. Si sigues arrastrando a la izquierda pasado el ancho mínimo, se cierra y el código ocupa todo el panel; si vuelves antes de soltar, sigue abierta. Doble clic en el borde la deja en el ancho por defecto. El ancho es el mismo en todos los paneles de editor y Deska lo recuerda. El botón de barra lateral al inicio de la fila de pestañas la muestra u oculta con ese ancho.
• Buscar en todo el proyecto: la barra lateral tiene dos pestañas, Archivos y Buscar. Pulsa Cmd/CtrlShiftF dentro de un archivo para abrir Buscar con tu selección (o la palabra bajo el cursor) ya escrita. Los resultados se agrupan por archivo, cada coincidencia con su línea marcada y numerada; un clic abre el archivo con la coincidencia seleccionada, un doble clic fija la pestaña. Los tres interruptores junto al campo son coincidir mayúsculas, palabra completa y expresión regular (Cmd/CtrlAltC, Cmd/CtrlAltW, Cmd/CtrlAltR). Incluir o excluir rutas muestra dos cajas de patrones (src/**, *.ts) y una casilla Usar archivos de exclusión que respeta .gitignore y omite node_modules, dist y build. Los archivos con cambios sin guardar se buscan tal como los ves, no como están en disco. Las flechas recorren los resultados, la izquierda pliega un archivo, Enter abre, Escape vuelve al campo. Buscar y reemplazar abre el campo de reemplazo: cada fila de resultado muestra entonces el texto viejo tachado y el nuevo a continuación, con un interruptor Conservar mayúsculas para que Needle se convierta en Thread. Reemplaza una coincidencia desde su fila, un archivo entero desde la fila del archivo, o todo con Reemplazar todo (Cmd/CtrlEnter en el campo), que pregunta antes. Los archivos con cambios sin guardar se modifican en el editor, donde puedes deshacer; el resto se escriben en disco tras comprobar de nuevo cada coincidencia. En una expresión regular, $1 se refiere a un grupo de captura. Tres chips bajo el campo limitan la búsqueda a lo que solo Deska sabe: Archivos cambiados (lo que git dice que cambió), Tocados por agentes (archivos que editó un hilo de agente) y Pestañas abiertas; haz clic derecho en una carpeta del árbol y elige Buscar en la carpeta para limitarla a esa carpeta. La flecha arriba en el campo recorre tus búsquedas anteriores. La página Explorador del cuaderno tiene las mismas pestañas Archivos y Buscar. Cuando una búsqueda termina, Preguntarle a Dex sobre esto abre Dex con la lista de resultados ya escrita y el editor adjunto como contexto, así solo añades lo que quieres que haga; Abrir en un panel nuevo copia la búsqueda en un panel de editor nuevo sobre el lienzo para que la lista se quede junto a tu trabajo. Mientras hay una búsqueda abierta, el archivo del editor muestra sus coincidencias con un fondo suave y marcas en la barra de desplazamiento, y F4 / ShiftF4 saltan a la coincidencia siguiente o anterior sin salir del búfer. Tus interruptores, patrones y alcance se recuerdan por proyecto; la consulta en sí no.
• Buscar en el árbol: la caja de filtro sobre el árbol busca por nombre de archivo y por contenido. Una coincidencia de contenido muestra la línea encontrada con lo que escribiste marcado y su número de línea; al abrirla, el editor aterriza en esa línea. Pulsa la flecha abajo para recorrer las coincidencias y Enter para abrir una. Escape vacía la caja; púlsalo otra vez con la caja vacía para volver al editor.
• Guardar con Cmd/CtrlS. Guardar un búfer sin título pide una ubicación. Formatear al guardar viene activado y ordena cada archivo al guardarlo; desactívalo en Ajustes → Editor, en Guardado. Al cerrar un editor con cambios sin guardar, Deska pregunta antes; su Guardar guarda todos los archivos con cambios de ese editor, también las pestañas que no estás viendo, y luego lo cierra. Si un archivo no se puede escribir, el editor se queda abierto con tus cambios y una barra dice por qué, con Reintentar.
• Imágenes, video y audio se abren como vista previa en la pestaña del editor en lugar de como texto. Una imagen se ajusta al panel sin agrandarse, sobre un tablero donde es transparente; haz clic en ella o pulsa Tamaño real para verla pixel por pixel. Copiar imagen pone la imagen en tu portapapeles (PNG y JPEG tal cual, otros formatos como PNG); haz clic derecho para la ruta, o pulsa Cmd/CtrlC después de hacer clic en ella. El video se reproduce con los controles de siempre y el audio en un reproductor pequeño, y el pie muestra las dimensiones, la duración y el tamaño. Un SVG se abre como imagen, con Código a un clic en la barra de pestañas. Los archivos se leen del disco por partes, así que una grabación larga avanza sin cargarse completa; arriba de 2 GB la pestaña dice que el archivo es demasiado grande. La vista previa se recarga cuando el archivo cambia en disco, así que una captura que un agente reescribe muestra su versión nueva. En una computadora de Deska Cloud o una con deska-agentd, las vistas previas abren archivos de hasta 100 MB. Las imágenes PNG, JPEG, GIF y WebP locales también se abren fuera de tu espacio de trabajo hasta 10 MB, si Deska puede leerlas. Vuelve a abrir esas vistas previas externas para ver cambios posteriores en el archivo. Los archivos comprimidos, fuentes y bases de datos dicen qué son en lugar de mostrar texto ilegible, y los PDF y archivos de Word se abren en su propio visor.
• Leer Markdown: los archivos .md y .mdx se abren como una página renderizada. El selector al final de la barra de pestañas elige Código, Dividida (el código junto a la página, con el desplazamiento sincronizado; doble clic en un párrafo para llevar el cursor a su línea) o Vista previa, y Cmd/CtrlE alterna entre la página y su código. Cada archivo recuerda su vista; elige cuál se abre primero en Ajustes, Editor, Markdown se abre en. La vista seleccionada siempre muestra su nombre; los paneles anchos muestran los nombres de las tres vistas. La página se lee como la muestra GitHub: las tablas conservan la alineación de sus columnas, el código se colorea con el tema de tu editor y muestra su lenguaje y un botón para copiar, > [!NOTE] y las demás alertas se convierten en avisos, el front matter aparece como propiedades, los bloques mermaid se dibujan como diagramas y las imágenes junto al archivo se ven en línea (en otra computadora quedan como enlaces que puedes abrir). El HTML del archivo pasa por la misma lista permitida de GitHub, así que los scripts y estilos nunca se ejecutan. Un índice En esta página sigue la sección que estás leyendo cuando el panel es ancho y queda detrás de un botón cuando es angosto; Cmd/CtrlF busca palabras en la página sin distinguir mayúsculas ni acentos. Un enlace a otro archivo lo abre como pestaña, en el encabezado al que apunta. La búsqueda queda sobre la página sin tapar el texto, incluso en paneles angostos. Pulsa Escape desde cualquier control de búsqueda para volver a leer. Abrir el índice enfoca la sección actual; elegir una sección devuelve el foco del teclado a la página.

  Ampliar captura

  

Control de código reúne los archivos preparados, sin preparar y nuevos en un solo acordeón Archivos cambiados. Cada archivo aparece una vez con su estado de preparación, estado de Git y contadores de líneas. Preparar todo incluye archivos modificados y nuevos; Quitar todo los retira del índice. Haz clic en la fila de un archivo para revisar sus diferencias; sus botones Descartar, Preparar y Quitar de preparados actúan sobre el archivo sin abrirlo. Si está preparado parcialmente, Preparado en parte abre las diferencias preparadas y el resto de la fila abre los cambios pendientes.

Ampliar captura

Alterna entre Cambios e Historial para darle a cada lista toda el área de contenido. Cambios reúne todos los archivos en un solo acordeón Archivos cambiados, con su estado de preparación, rutas, contadores de líneas y un botón Preparar todo que incluye archivos modificados y nuevos. El área de commit identifica el mensaje e indica cuántos archivos están preparados. Cambiar de vista conserva tu borrador. Historial muestra los títulos y fechas; expande un commit para ver su autor, título completo, hash, referencias y archivos modificados. Mostrar commits anteriores carga más historial.

Bajo la cabecera, una franja de sincronización te dice qué queda pendiente entre este checkout y su remoto, y lleva el botón que lo resuelve: 3 commits por subir con un Push, mi-rama aún no está en origin con un Publicar rama, o 2 commits por traer con un Pull. Una rama que divergió en ambos sentidos nombra las dos mitades y ofrece Pull primero. Cuando no queda nada pendiente, la franja no aparece.

Un cuadro de confirmación se sitúa en la parte inferior. Escribe un mensaje y pulsa Cmd/CtrlEnter (o haz clic en Commit) una vez que algo esté preparado. Hacer solo commit está bien: en cuanto aterriza, aparece un botón Hacer push justo debajo del cuadro, así que nunca tienes que buscar cómo subir el commit. Corregir el último reemplaza el commit anterior en lugar de añadir uno y precarga su mensaje, y funciona sin nada preparado cuando lo único que quieres es reescribirlo.

En la cabecera, Pull solo aparece cuando hay algo de dónde traer cambios, Push cuenta lo que espera (Push 3) y se lee como Publicar rama mientras la rama todavía no tiene upstream, y un chip de pull request o merge request puede aparecer junto a ellos cuando tu rama tiene uno abierto.

El panel de Git del lienzo conserva la disposición anterior de tres pestañas: Cambios, Historial y Ramas, con la misma cabecera, franja de sincronización y cuadro de confirmación.

Control de código, los worktrees y los commits de tus agentes funcionan con Git. Clonar desde GitHub, hacer push y abrir pull requests pasa por la CLI de GitHub (gh). Windows no trae ninguna de las dos, y una Mac recibe Git con las Command Line Tools de Apple. Cuando falta una en la computadora que tienes enfrente, Deska dice cuál y la instala por ti:

• En Herramientas y cuentas, la fila de GitHub dice Git no está instalado o La CLI de GitHub no está instalada, y Configurar abre tres pasos: instalar Git, instalar la CLI de GitHub e iniciar sesión en GitHub. Cada paso muestra el comando que corre antes de que presiones nada.
• Control de código en una computadora sin Git dice Git no está instalado en esta computadora y ofrece Instalar Git. Vuelve a ser Control de código por sí solo en cuanto Git responde.
• La tarjeta Termina de configurar del escritorio suma una fila Git no está instalado, y Clonar desde GitHub ofrece Configurar GitHub cuando falta la CLI de GitHub.

En Windows, Instalar corre winget install en una terminal de tu escritorio, y puede que Windows pida permiso primero. En una Mac, Instalar Git abre la ventana de instalación de Apple, y la CLI de GitHub se instala con Homebrew. Sin winget ni Homebrew, y en Linux, el paso abre la página de descarga (git-scm.com o cli.github.com). Cada paso vuelve a revisar solo, así que nunca reinicias Deska para ver el cambio.

Dos de las pequeñas tareas que rodean a un commit se pueden delegar. Un botón Generar en el cuadro de confirmación redacta un mensaje a partir de lo que has preparado, y el formulario de nueva rama convierte una descripción en lenguaje llano (“fix the flaky upload retry”) en un nombre de rama con el estilo de tu repositorio.

Ambos se ejecutan solo cuando haces clic, nunca en segundo plano, y ambos dejan el resultado editable, así que es un primer borrador y no una decisión. La diferencia preparada se lee donde vive y solo vuelve el texto redactado.

El botón Commit es un botón dividido. Su menú encadena los pasos que casi siempre haces juntos y luego te devuelve la ejecución paso a paso, para que veas exactamente hasta dónde llegó:

• Commit y push, que pasa a ser Commit y publicar rama cuando la rama todavía no tiene upstream.
• Commit, push y Pull request, que ejecuta esos mismos dos pasos y luego crea la solicitud a través del CLI de tu forja. En un remoto de GitLab la entrada se lee como Commit, push y Merge request.

La entrada se nombra con el vocabulario de tu propia forja. Donde Deska no puede actuar, sigue visible pero deshabilitada con el motivo al lado: no hay remoto, es una forja que Deska no maneja, o el CLI de la forja no está instalado. En GitLab la entrada indica que Deska no puede crear merge requests ahí. Hoy GitHub es la forja en la que Deska puede completar el flujo, mediante el CLI gh.

El panel Explorador de archivos es un navegador de archivos, no un árbol del proyecto. Abre en la carpeta donde está tu worktree y desde ahí va a donde quieras: dentro de una carpeta, de vuelta hacia afuera, y por encima del proyecto, por todo el disco.

• Doble clic en una carpeta para abrirla. El nombre de la carpeta en la barra superior es un menú con todas las carpetas que están por encima, y la ruta de abajo te saca de una en una con un clic.
• Tres vistas. Iconos (con vista previa de las imágenes), una lista con columnas ordenables Nombre, Fecha de modificación, Tamaño y Tipo, y columnas para recorrer varios niveles a la vez. Cada panel recuerda la suya.
• Lugares en el lateral. Home, Desktop, Documents, Downloads, Applications, tus proyectos abiertos y cualquier volumen montado. Clic derecho en una carpeta para añadirla a Favoritos.
• El teclado funciona. Las flechas mueven, Enter abre, Cmd/CtrlUp sube a la carpeta contenedora, Cmd/Ctrl[ y Cmd/Ctrl] son atrás y adelante, y al escribir salta al nombre.
• Sigue conociendo Git. Dentro de un repositorio, los nombres llevan las mismas letras de estado (modificado, sin seguimiento, eliminado, en conflicto) que usa el resto de Deska.
• Clic derecho para el menú completo: nuevo archivo o carpeta, renombrar, duplicar, copiar, pegar, eliminar, abrir en una terminal, abrir como proyecto, o mostrar en el gestor de archivos de tu sistema. Los archivos ocultos son un interruptor en las opciones de vista.

1. Abre un archivo desde el explorador de archivos y haz tus ediciones en el editor.
2. Guarda con Cmd/CtrlS.
3. En la página Control de código del cuaderno (o en la pestaña Cambios del panel de Git), haz clic en el archivo para revisar la diferencia, y luego prepáralo.
4. Escribe un mensaje de confirmación (o genera uno) y pulsa Cmd/CtrlEnter.
5. Haz Push desde la cabecera de Git, o usa el botón dividido de Commit para confirmar, publicar y abrir el pull request en una sola ejecución.

Las diferencias son de solo lectura y lado a lado: el original a la izquierda, tu copia de trabajo a la derecha, las adiciones en verde y las eliminaciones en rojo. Para editar, abre el archivo de la forma normal en lugar de a través de la diferencia. Dónde aparece la diferencia depende de dónde hiciste clic:

• Desde el árbol de archivos dentro de un panel de editor, la diferencia se abre como otra pestaña en ese mismo editor, marcada como diferencia en la tira de pestañas. Tus demás pestañas se quedan exactamente donde estaban, y una ruta es o bien una pestaña normal o bien una pestaña de diferencia, nunca ambas.
• Desde el panel de Git, la diferencia se abre como su propia página de editor en el cuaderno, a la derecha, titulada con el nombre del archivo más (diff preparado) o (diff de trabajo).

Desde las páginas Control de código y Explorador del cuaderno, la diferencia se abre como una parada dentro de esa misma página en lugar de un editor acoplado, así que la revisión se queda en el propio recorrido del cuaderno.