Espacios de trabajo y el lienzo

Nuevo espacio de trabajo ofrece Abrir una carpeta, Clonar desde GitHub y Clonar desde una URL para clonar un repositorio. Proyectos recientes permite reabrir proyectos locales. El control de computadora indica dónde estará el proyecto. El texto se mantiene legible sobre el fondo, con acciones para empezar un lienzo vacío, añadir un panel, importar y abrir la documentación en el pie. Las computadoras locales y remotas comparten el mismo flujo para iniciar sesión en GitHub, explorar carpetas y crear una nueva. Clonar repositorio muestra el repositorio, la carpeta contenedora, el nombre de la carpeta y el destino final antes de empezar, y nombra la rama solo cuando el enlace que pegaste apunta a una. Cambiar de computadora borra las selecciones de la computadora anterior. En esta computadora, la ruta completa indica si Deska creará una carpeta nueva o usará una vacía existente. Si contiene archivos, la ruta es relativa o no tienes permiso para escribir, Deska avisa antes de clonar. Recuerda la carpeta contenedora del último clonado aceptado por separado para cada computadora; la primera vez en local propone Projects dentro de tu carpeta personal. Siempre puedes editar el destino o elegir otra carpeta. En remoto, Git comprueba el destino al iniciar el clonado.

Cada espacio de trabajo es un único lienzo infinito y sin bordes. Los paneles flotan en posiciones fijas dentro del espacio del lienzo, y tú mueves una vista sobre ellos: así toda la disposición escala con suavidad a medida que haces zoom, y siempre hay más sitio para extenderse.

Ampliar captura

Una cuadrícula tenue en el fondo te ayuda a alinear las cosas. Haz clic en cualquier área vacía para quitar el foco actual.

Hay varias formas naturales de moverte:

Ampliar captura

• Desplázate con un scroll de dos dedos en el trackpad, o manteniendo el botón derecho del ratón y arrastrando. Un arrastre con el botón derecho se suelta con un poco de inercia para que se sienta físico. Un scroll que empieza dentro del panel en el que estás trabajando se queda en ese panel hasta que te detienes, aunque llegues al principio o al final de su contenido, así que el canvas no se mueve debajo.
• Haz zoom manteniendo Cmd/Ctrl y desplazándote: hacia arriba para acercar, hacia abajo para alejar. El zoom se ancla en tu cursor.

O usa el teclado:

• Cmd/Ctrl= acerca, Cmd/Ctrl- aleja.
• Cmd/CtrlShift0 restablece al 100%.
• Cmd/CtrlShift1 hace zoom para encuadrar todos los paneles en la vista.

Al alejarte por debajo de aproximadamente el 45%, el lienzo se convierte en una vista general donde cada panel se muestra como una imagen de sí mismo. Deska toma las imágenes mientras la cámara está quieta y renueva las de los paneles que cambiaron, de a un panel, cada par de segundos. Hasta su primera imagen, un panel muestra un boceto de lo que contiene, como los últimos turnos de un chat, las últimas líneas de una terminal, las primeras líneas de un archivo o una nota, y un panel que te espera dice Te necesita. El panel en el que estás trabajando y los paneles que están trabajando, un agente en pleno turno o una terminal que imprime, siguen dibujándose en vivo, hasta unos diez, los más cercanos al centro de la pantalla. Unos segundos después de que uno se detiene, Deska toma su imagen tal como está y la imagen ocupa su lugar. Todos los demás siguen trabajando detrás de su imagen: los agentes siguen corriendo, las terminales conservan su salida y las páginas siguen reproduciéndose y nunca se recargan. Haz clic en una tarjeta para seleccionarla, arrástrala para mover el panel, arrastra su borde para cambiar su tamaño y haz doble clic para volver a acercarte a ese panel. Por encima del 50% todos los paneles vuelven a estar en vivo, tal como los dejaste. Al abrir un escritorio, Deska dibuja primero lo que estás viendo y luego prepara el resto en segundo plano, de a un panel, para que los paneles a los que llegues ya estén listos; un navegador carga su página la primera vez que aparece en pantalla.

Agrega paneles desde la Biblioteca de paneles (Cmd/CtrlShiftE) o haciendo clic derecho en un lienzo vacío. Un panel creado desde el menú del clic derecho, tareas incluidas, aparece donde hiciste clic: en lienzo libre justo ahí, y junto a otros paneles se alinea con ellos para que el escritorio quede ordenado. Los paneles que agregas sin un punto (un botón de la barra, un atajo) toman el siguiente lugar libre de la cuadrícula. En los dos casos el panel nuevo recibe el foco. O haz doble clic en el lienzo vacío: una paleta de paneles compacta aparece donde hiciste clic y crea el panel en ese punto exacto. La Paleta de comandos (Cmd/CtrlK) también agrega paneles, pero sus Nueva terminal, Nuevo navegador y Nuevo editor se abren como páginas del cuaderno, a la derecha, y no en el lienzo.

• Enfoca un panel haciendo clic en su barra de título: gana un resplandor y sube al frente.
• Muévelo arrastrando la barra de título; cambia su tamaño desde cualquiera de los ocho tiradores que lo rodean.
• Maximiza o restaura haciendo doble clic en la barra de título.
• Cierra el panel enfocado con Cmd/CtrlW, o elimínalo con Cmd/CtrlBackspace.
• Cambia el foco con Ctrl` y CtrlShift`, o abre el Selector de paneles con CtrlSpace.

A medida que un lienzo se llena, puedes organizarlo. Haz clic y arrastra sobre el lienzo vacío para seleccionar paneles con un marco, o Cmd/CtrlA para seleccionarlo todo.

• Agrupa en una región con Cmd/CtrlG, que alinea los paneles seleccionados en una cuadrícula ordenada de igual tamaño y dibuja una región a su alrededor, con el nombre listo para escribir. Disuelve las regiones con Cmd/CtrlShiftG.
• Ordenar el lienzo (Cmd/CtrlShiftL) reorganiza todos los paneles y regiones en una disposición sin solapamientos y ajusta el zoom para encuadrarlos. Para ordenar solo algunos paneles, selecciónalos y haz clic derecho para Ordenar en cuadrícula, Apilar en fila o Apilar en columna.
• Haz clic derecho en el lienzo vacío para el menú de creación: Nueva tarea, Nueva terminal, Nuevo editor, Nuevo navegador y Nueva nota adhesiva, un submenú Fijados con los paneles que fijaste en la Biblioteca de paneles, una entrada Biblioteca de paneles, y pegar (una URL se convierte en un navegador, el texto plano se convierte en una nota adhesiva). Con paneles seleccionados, el mismo menú empieza por lo que puedes hacer con ellos: agruparlos en una región, ordenarlos, deseleccionarlos o borrarlos. Las regiones y las etiquetas de texto viven en la Biblioteca de paneles.

Una región es un área del lienzo con nombre. El nombre va en una pestaña en su esquina superior izquierda, y esa pestaña es por donde la manejas:

• Arrastra el nombre para mover la región con todo lo que tiene dentro. Un clic en el nombre selecciona la región y un doble clic la renombra. Una región recién creada empieza con el nombre listo para escribir.
• Dentro de una región sigue siendo lienzo. Un clic en su área vacía quita la selección, arrastrar ahí dibuja un marco de selección alrededor de sus paneles, y un doble clic abre la paleta de paneles en ese punto. Haz clic derecho dentro de una región para su menú: paneles nuevos en ese punto, Renombrar, Color, una carpeta predeterminada para las terminales que abras dentro, Seleccionar los paneles de dentro, Disolver región y Eliminar región….
• Lo que ves dentro es lo que se mueve. Un panel pertenece a la región en la que está su centro, así que los paneles que abras o sueltes dentro de una región se mueven con ella, y también una región dibujada dentro de otra. Pasa el puntero por el nombre de una región para ver qué paneles tiene. Mientras arrastras un panel sobre una región, la región se ilumina y el panel dice Drop into y el nombre de la región.
• Color: el punto antes del nombre elige uno de los seis colores de las ventanas, o ninguno. Una región seleccionada muestra un tirador en cada esquina para cambiar su tamaño. Esc deshace un movimiento o un cambio de tamaño mientras aún arrastras, y Cmd/CtrlZ deshace cualquiera de los dos después.
• Pídele a Dex que use una región: Dex ve los nombres de las regiones y los paneles que tienen dentro. Pide “¿qué hay en la región Revisión?” o “abre tres paneles de tareas en Revisión, yo los lleno”. Darle a una tarea una instrucción para trabajar la arranca ahí; pedir paneles vacíos abre borradores para que los llenes. También puedes seleccionar una región y decir “en esta región”. La región crece si los paneles lo necesitan y hay espacio. Si el nombre no existe o lo comparten varias regiones, Dex necesita que identifiques la región antes de colocarlos.

Deska mantiene su interfaz ligera y pegada a los bordes, para que los controles que más usas estén siempre a mano sin estorbar tu trabajo:

• Los clústeres de las esquinas (arriba): clústeres flotantes de cristal en lugar de una barra de título a todo lo ancho. El de arriba a la izquierda lleva la marca y la miga que nombra la computadora, el proyecto, el worktree en el que estás y sus tareas (por ejemplo local ▸ my-app ▸ main ▸ Nueva tarea); el de arriba a la derecha lleval Marketplace (skills, bundles de skills y paneles de la comunidad), tu teléfono, la búsqueda, el engranaje de ajustes, las notificaciones y tu cuenta.
• El riel de proyectos (borde izquierdo): los mosaicos de tus espacios de trabajo en la isla Espacios. Bajo cada mosaico hay una rayita por worktree (un proyecto con un solo worktree no tiene ninguna, y pasadas cinco una rayita redonda de más abre la isla), en el mismo orden en que la isla las lista: pasa el cursor por una rayita para leer su rama y haz clic para cambiarte allí. Al pasar el cursor por la isla, se abre a su lado un panel que lista cada proyecto con todas sus ramas debajo; el pin al pie del riel lo mantiene abierto. Es la única interfaz del lado izquierdo. Consulta la Visión general de los paneles.
• La isla Add (abajo): una píldora de cristal junto al centro de voz con el botón Agregar panel, que abre la Biblioteca de paneles, y una tira de creación rápida (editor, terminal, navegador, nota y Nueva tarea).
• El botón Extras (abajo a la izquierda): abre un solo panel con una nota rápida, el temporizador de concentración y el reproductor de música. Mientras corre una sesión de concentración, el botón cerrado muestra la cuenta atrás.
• El centro de voz (abajo al centro): el hogar de Dex, donde escribes o le hablas al asistente.
• El clúster de navegación (abajo a la derecha): el tiempo de enfoque de hoy, que abre ayer, los últimos 7 días y la pausa, y luego un minimapa junto a una píldora de zoom (el interruptor de resúmenes de paneles, alejar, el porcentaje actual, acercar y ajustar a la vista). El minimapa es una vista a vuelo de pájaro de cada panel y región, con un rectángulo que marca dónde estás mirando. Cada panel muestra lo que necesita de ti: verde mientras un agente trabaja, ámbar cuando uno te necesita, rojo para una ejecución que falló y azul para una que terminó y todavía no has mirado. El rojo y el azul vuelven a gris en cuanto miras la tarea, los demás paneles quedan en gris, y aquel en el que estás, en un gris más claro. Haz clic en un panel para ir a él, haz clic o arrastra en cualquier otra parte para mover la vista, o activa y desactiva el minimapa con Cmd/CtrlShiftM.
• El cuaderno (a la derecha): un compañero flotante cuyas páginas son paneles, que plegado se ve como una columna estrecha de iconos llamada Herramientas y que se despliega y se pliega con Cmd/CtrlJ. Úsalo para lo que quieres tener al lado de tu trabajo sin darle sitio en el lienzo. Consulta Notas y el cuaderno.
• El cursor de tiempo: un deslizador opcional sobre el lienzo para retroceder por disposiciones guardadas. Mira Instantáneas y viaje en el tiempo más abajo.

Los paneles no tienen por qué flotar por separado. Dentro de un nodo del lienzo puedes combinar paneles en pilas de pestañas y divisiones: práctico para mantener, por ejemplo, dos editores o un editor y su terminal en un mismo bloque ordenado.

• Arrastra una pestaña a un divisor de división para dividir el nodo; arrástrala al centro para fusionar.
• El botón + en una tira de pestañas agrega un panel más del tipo de la pestaña activa. El botón de división te deja elegir una dirección y un tipo de panel.
• Arrastra una pestaña hacia afuera para sacarla a su propio nodo flotante o a una ventana separada.

Dos ventanas también pueden viajar juntas sin compartir un marco. Arrastra una ventana hasta el borde exterior de otra hasta que ese borde se ilumine y la vista previa diga Suelta para unir. La ventana prendida conserva su aspecto y su tamaño. Desde ese momento se mueve con la otra ventana, sigue su borde cuando esa ventana cambia de tamaño y se oculta mientras está minimizada o maximizada.

Las notas adhesivas se adhieren a la esquina superior derecha: la nota queda superpuesta sobre la ventana y conserva su tamaño sin dividir el panel. Cada ventana admite una nota, que la sigue cuando la mueves o redimensionas. También puedes usar Adherir a ventana en el menú de la nota. Consulta Notas adhesivas en el lienzo.

• Arrastra la ventana prendida lejos para soltarla, o haz clic derecho sobre ella y elige Separar de la ventana.
• Cerrar la ventana a la que está prendida la deja donde está, por su cuenta.
• Soltar otros paneles dentro de una ventana los sigue apilando o dividiendo. Las notas adhesivas quedan separadas y nunca se convierten en pestañas o divisiones.

Cada proyecto tiene su propio espacio de trabajo: un lienzo separado con sus propios paneles, zoom y vista. El riel de proyectos del borde izquierdo los lista como mosaicos de color en su isla Espacios. Crea, renombra, recolorea, reordena o cierra espacios de trabajo desde ahí, y arrastra un mosaico sobre otro para plegarlos en una carpeta.

• Haz clic en un mosaico para cambiar, o salta directamente a uno con Cmd/Ctrl1 hasta Cmd/Ctrl9 (y Cmd/Ctrl0 para el décimo), siguiendo el orden del riel.
• Alterna con CtrlTab y CtrlShiftTab.
• Dale a cada espacio de trabajo un color y un icono de un registro de más de 200 glifos, dibujado sobre el mosaico de color del propio espacio de trabajo. Cada espacio de trabajo empieza con un icono por defecto derivado de su identidad, así que ningún mosaico queda nunca en blanco.
• Ocultar espacio de trabajo (clic derecho en un mosaico) saca un proyecto del riel sin cerrarlo. Queda en la sección plegada espacios de trabajo ocultos al final del riel, y tu teléfono lo ordena igual: bajo Ocultos, al final de los proyectos de esa computadora.

Un espacio de trabajo contiene un proyecto, y un proyecto puede contener varios worktrees, en el sentido que git le da a la palabra: el checkout principal, las ramas que cortas tú mismo con Nuevo worktree y los checkouts que un agente mantiene mientras trabaja. Cada worktree tiene su propio lienzo. Cambia de worktree y toda la superficie cambia contigo; la disposición que dejaste está exactamente donde la dejaste cuando vuelves. La primera vez que abres un worktree te muestra su trabajo: el chat de su tarea, o una terminal si está vacío. Después, volver nunca mueve nada.

Ampliar captura

• Los mosaicos de espacio de trabajo del riel muestran rayitas, una por worktree, para que veas de un vistazo cuánto está pasando dentro de un proyecto.
• Una miga en la parte superior de la interfaz nombra el worktree en el que estás y sigue tu foco; pasa el cursor por ella o haz clic para abrir el selector de worktrees.
• El selector está hecho para navegar muchos worktrees: tu checkout principal va primero y el resto sigue según cuándo estuviste en cada uno, con la edad junto a cada fila. Empieza a escribir para buscar por rama o por título de la tarea, muévete con las flechas y salta con Enter. Unas pestañas arriba separan Todos, Activos y Fusionados; los worktrees con PR fusionado se hunden al fondo. Haz clic derecho en cualquier fila para abrir su pull request, copiar el nombre de la rama o eliminarlo.
• Cmd/CtrlEnter abre la superposición de salto desde cualquier lugar, salvo mientras escribes en un editor, una terminal o un campo de texto, donde envía: cada proyecto y cada worktree, a una pulsación de distancia. Las pestañas de espacios de trabajo recorren la parte superior y Tab las alterna; los mosaicos de worktree llenan la cuadrícula de abajo, donde 1 a 9 saltan directamente a uno y N corta uno nuevo.

El checkout detrás de un worktree nuevo vive en ~/deska/workspaces/<proyecto>/<rama>, así que siempre puedes llegar a él desde una terminal y la carpeta padre de tu proyecto se mantiene limpia. Los worktrees creados por versiones anteriores de Deska en la carpeta hermana .worktrees siguen funcionando donde están.

En el selector de worktrees, cada worktree que se puede quitar muestra quitar al pasar el cursor sobre su fila, y el clic derecho ofrece Quitar worktree…. La carpeta siempre se va. Su rama se va también solo cuando no se pierde nada de ella: cada commit de la rama también existe en otra rama, en una rama remota o en un tag, o su pull request está fusionado. Si la rama tiene commits propios, la confirmación dice cuántos y ofrece Conservar la rama o Eliminar también la rama. La confirmación también dice cuántos archivos sin commit se van con la carpeta.

Antes de que se pierda algo, sean archivos sin commit o los commits propios de una rama que eliminas, Deska guarda una copia oculta durante 30 días, y Dex puede recuperarla: pídele que restaure la rama. Los archivos ignorados, como node_modules o .env, no forman parte de esa copia; se van con la carpeta.

• Limpiar: cuando hay algo que limpiar, la cabecera del selector muestra Limpiar N. Una sola confirmación elimina cada worktree que no pierde nada, junto con su rama, y borra las ramas deska/ sobrantes que dejaron tareas fallidas o eliminadas sin nada propio. Deja en paz el worktree en el que estás, cualquier worktree con archivos sin commit, con commits propios y sin un pull request fusionado, o con un agente trabajando o una terminal abierta en él, y el worktree de una tarea hasta que la tarea esté detenida, asentada o archivada. Nunca borra una rama fuera de deska/ que no tenga worktree. Las filas que tomaría dicen listo para limpiar.
• Todos los worktrees termina con una franja Listos para limpiar que lista los mismos worktrees y ramas con casillas, para que desmarques lo que quieras conservar.
• Ya no hay una acción Tidy aparte: un worktree fusionado es simplemente una eliminación en la que no se pierde nada, y el panel Checks de un pull request fusionado ofrece Eliminar este worktree.

Eliminar el worktree de una tarea también detiene la tarea; consulta Worktrees de git aislados. Dex puede listar tus worktrees con lo que perdería eliminar cada uno, eliminar uno, hacer la limpieza y recuperar una rama eliminada. Borrar los commits propios de una rama siempre te pide confirmación, incluso con Ajustes → Dex → Actuar sin preguntar encendido.

Cuando haces malabares con varios proyectos, pulsa Cmd/CtrlShiftP o haz clic en Todos los espacios de trabajo, bajo los mosaicos del riel de proyectos, para abrir la vista general de espacios de trabajo, titulada Tus espacios de trabajo. Muestra una tarjeta por cada espacio de trabajo abierto, con la identidad del espacio de trabajo, su número de paneles y cuántos agentes trabajan o esperan a la cabeza, y una fila por cada worktree debajo: el checkout principal, las ramas que cortas tú mismo y cualquier checkout que un agente esté manteniendo.

• Haz clic en la fila de un worktree para aterrizar en ese worktree exacto; haz clic en el nombre del espacio de trabajo o en Abrir espacio de trabajo para entrar al espacio de trabajo en lo último que estaba mostrando.
• Un espacio de trabajo sin worktrees que listar muestra en su lugar una miniatura de su lienzo, así que cada tarjeta responde la misma pregunta: ¿dónde puedo aterrizar aquí?
• La última tarjeta, Nuevo espacio de trabajo, crea un espacio de trabajo. Haz clic derecho en una tarjeta para abrir el menú del espacio de trabajo: renombrar en el sitio, duplicar o cerrar.

¿Necesitas un panel en un segundo monitor? Arrastra una pestaña o toda una zona de acoplamiento fuera de la ventana principal, o haz clic derecho en una pestaña y elige Mover a una ventana nueva, para abrirla como su propia ventana. Se queda encima de la ventana de Deska de la que salió, así que un clic en el lienzo nunca la esconde, y vuelve cuando abres Deska de nuevo. Una tarea conserva ahí toda su conversación. Para devolver un panel, arrastra su pestaña a la ventana principal; al cerrar la ventana se cierran los paneles que contiene.

Todo persiste automáticamente. Las posiciones de los paneles, los tamaños, el zoom, la disposición de acoplamiento, el historial de la terminal, el estado del editor y el historial del navegador se guardan por espacio de trabajo y se restauran cuando vuelves a abrir Deska, sin necesidad de un botón de guardar. Deska vuelve a abrir el espacio de trabajo en el que estabas, en la computadora donde vive, y al cambiar a otra computadora llegas al proyecto que dejaste allí.

Deska puede mantener en silencio un historial rotativo de la disposición de tu lienzo. Con las instantáneas activadas, guarda en segundo plano la disposición de tus paneles y regiones, unos segundos después de que todo se asiente, y conserva las más recientes por espacio de trabajo; las más antiguas se van descartando a medida que llegan nuevas.

Activa el cursor de tiempo y aparecerá un deslizador sobre el lienzo. Arrástralo hacia atrás y cada parada previsualiza una disposición anterior, etiquetada con cuánto tiempo hace y cuántos paneles tenía; al soltar, Deska te pregunta antes de restaurar esa disposición, para que nunca reemplaces la actual por accidente. Suéltalo en el extremo derecho para quedarte en el presente.