Referencia
Ajustes y personalización
Abre Settings con Cmd/Ctrl+coma. Veintidós páginas se reparten en siete grupos a la izquierda, y el cuadro de búsqueda de arriba encuentra cualquier ajuste por su nombre.
Cómo se organiza Settings
Pulsa Cmd/Ctrl, para abrir Settings. La columna izquierda agrupa todas las páginas en siete grupos:
- AI capabilities contiene Dex, Coding agents y Provider keys.
- Set up contiene Getting started, General, Account y Updates.
- Workflows contiene Git and worktrees, Terminal, Editor, Browser y Notes.
- Interface contiene Appearance, Canvas, Panels and layout, Notifications, Keybindings y Focus and stats.
- Remote and mobile contiene Remote access.
- Privacy and security contiene Permissions and approvals y Privacy and telemetry.
- Advanced contiene Diagnostics.
El cuadro de búsqueda de arriba recorre etiquetas, descripciones y palabras clave de todas las páginas, así que puedes escribir scrollback o beta en vez de buscar la página correcta a mano. Los enlaces antiguos siguen funcionando: una página que se movió redirige a su nuevo lugar.
Dex
El asistente que te responde, y hasta dónde puede llegar. Dos grupos: Who answers y Voice.
- Coding agent: cuál de tus agentes instalados (Claude Code, Codex, opencode) responde en Dex. El asistente funciona sobre tu propio agente y su sesión, así que esta fila es toda la historia de quién hace el razonamiento.
- Voice: Voice & dictation shortcuts salta directamente a la página de Keybindings para Dex, Talk to Dex y el dictado, y Voice tips vuelve a mostrar el consejo de voz único después de tu siguiente dictado.
Consulta Agentes y Dex para ver cómo trabaja el asistente con el resto del lienzo.
Coding agents
Las CLI detrás de cada hilo supervisado. Tres grupos: Instances, Tools y Keeping CLIs current.
- Instances: configuraciones con nombre para los agentes estructurados (Claude, Codex, opencode). Una instancia de trabajo y otra personal pueden tener cada una su propio binario, su directorio home y su modelo por defecto. Cada instancia elige además un modo de ejecución: Provider default, Approval required, Auto-accept edits, Auto (AI reviews risky actions) o Full access. Un modo que el modelo elegido no puede respetar aparece desactivado con su motivo, en lugar de degradarse en silencio.
- Browser preview tools: permite que los agentes supervisados abran y manejen un panel de navegador para comprobar su propio trabajo de frontend.
- CLI update checks: compara las CLI de proveedor que tienes instaladas con el registro de npm y muestra un aviso de actualización en sus filas de instancia.
- Restore agent sessions: vuelve a abrir las conversaciones de agentes (Claude Code, Codex, Cursor y compañía) en las terminales restauradas cuando se reabre un espacio de trabajo.
Los interruptores que dejan a un agente actuar sin preguntar viven en Permissions and approvals, descrito más abajo. Consulta Agentes de código para saber qué permite realmente cada modo.
Provider keys
Guarda tus propias claves de modelos. Deska las mete en el almacenamiento seguro de tu sistema operativo y nunca vuelve a ver el valor. Los proveedores son Anthropic (Claude), OpenAI, Groq, Google Gemini, OpenRouter y Fish Audio (voice). Esta página está disponible en todos los planes de pago; en el plan gratuito permanece oculta. Las claves nunca son lo que hace funcionar al asistente: tu agente de código siempre corre con su propia sesión de CLI, y la cuota gestionada cubre solo la voz. Consulta Agentes y Dex y Planes y facturación.
Getting started, General, Account, Updates
El grupo Set up es el mantenimiento a nivel de app:
- Getting started: repite el recorrido del primer arranque y abre esta documentación. Consulta Inicio rápido.
- General: qué hace Deska al abrirse (On launch), y Backup and transfer: exporta el espacio de trabajo actual como un paquete
.workspaceportátil, o importa uno en otra máquina. - Account: inicia o cierra sesión, consulta el plan en el que estás, tus computadoras vinculadas y los minutos de voz que te quedan, y salta a la facturación en Deska Cloud. El dictado y las respuestas habladas comparten una sola cuota, así que esta página muestra una sola cifra. Cuando no has iniciado sesión simplemente dice Not signed in y Deska sigue funcionando en local.
- Updates: la versión que estás usando, un botón que recorre todo el flujo de actualización (Check for updates, luego Download v…, luego Restart to update), los puntos destacados de la versión actual y el canal de publicación (Stable o Beta). Deska comprueba en segundo plano, pero nunca descarga sin ti. El flujo completo está en Actualizaciones.
Workflows: Git, Terminal, Editor, Browser, Notes
Una página por superficie de trabajo:
- Git and worktrees: cómo Deska crea ramas para tareas nuevas y se mantiene al día con tus remotos. Background fetch define los minutos entre ejecuciones silenciosas de
git fetchpara que las cuentas de adelanto y retraso sigan al día. Viene en 0, lo que significa que Deska nunca contacta un remoto por su cuenta; cualquier valor por debajo de 5 se eleva a 5. - Terminal, Shell: en Windows, elige PowerShell, Command Prompt o Git Bash. Un Default shell path tiene prioridad sobre eso en cualquier plataforma; déjalo en blanco para detectarlo automáticamente.
- Terminal, Text: sustituciones de familia y de tamaño de fuente. Déjalas en sus valores por defecto para seguir a la app.
- Terminal, Smart actions: Deska observa la salida en busca de enlaces de inicio de sesión, códigos de dispositivo, rutas de archivo, comandos sugeridos y fallos, y ofrece acciones de un clic. AI-filtered hints pregunta a Dex si una pista detectada merece mostrarse antes de que aparezca.
- Terminal, Performance: Scrollback buffer define cuántas líneas guarda cada terminal, y Auto-suspend idle background terminals pausa las terminales silenciosas y fuera de pantalla tras dos minutos para que el sistema operativo recupere memoria (solo en macOS y Linux).
- Terminal, Theme: elige una paleta de terminal o importa la tuya.
- Editor: tamaño de fuente, ancho de tabulación y formateo al guardar.
- Browser: página de inicio, motor de búsqueda y qué hacer cuando aparece una URL en la salida de una terminal (Off, Automatic o Ask before opening).
- Notes: Note vault folder decide dónde se escriben las notas como archivos markdown. Déjalo en blanco para la ubicación por defecto, o apúntalo a un vault de Obsidian para editarlas ahí.
Consulta Terminales y Navegador y widgets para ver qué pueden hacer estos paneles.
Appearance
El tema, el acento y los toques ambientales alrededor del lienzo, en tres grupos: Theme and colours, Effects y Window.
- Theme: una cuadrícula con nueve estilos. system es el valor por defecto y sigue a tu sistema operativo. Los demás son system light, dark warm, dark cold, light subtle, dracula, cyber wave, pink city y adeberry. Tres de ellos son claros: system light, light subtle y pink city.
- Accent color: una fila de muestras para resaltados y anillos de foco. La primera opción es theme default, que sigue el acento que trae el tema activo. Las alternativas con nombre son cyan, teal, iris, pink, amber y rose, y todas siguen siendo legibles en cualquier tema.
- Effects: Ambient mode desplaza el tono del lienzo según la hora del día, Project tint lleva el color del espacio de trabajo a la cuadrícula y al resplandor de foco, y Focus time pill muestra en la barra de título tus horas de concentración de hoy.
- Native macOS window tabs: solo en macOS, y solo aparece ahí.
El fondo del lienzo y la cuadrícula se movieron a la página Canvas, descrita a continuación.
Canvas
La superficie en sí: su fondo, cómo se mueve y qué recuerda. Tres grupos: Background, Navigation e History.
- Grid style: el patrón dibujado detrás de tus paneles, ya sea Dots, Lines o None. Dots es el valor por defecto.
- Canvas background: un color sólido, un degradado, uno de los preajustes animados incluidos, o tu propia imagen o GIF.
- Zoom speed: un multiplicador de 0.5x a 3.0x sobre el zoom con rueda o trackpad.
- Auto-focus largest visible panel: activa el panel que ocupa más área visible mientras haces zoom o te desplazas. Desactivado por defecto.
- Rotating snapshots: guarda hasta 50 copias por espacio de trabajo. Show time scrubber añade la píldora flotante que las recorre.
El lienzo en sí se explica en Espacios de trabajo y el lienzo.
Panels and layout, Notifications, Keybindings, Focus and stats
- Panels and layout: cómo se organizan los paneles. Tab orientation define la disposición por defecto de las tiras de pestañas de los paneles, Horizontal o Vertical; cualquier panel puede cambiarla desde su propia cabecera.
- Notifications: Enable notifications muestra una notificación del sistema operativo cuando algo te necesita, y Only when window unfocused las silencia mientras Deska es la ventana enfocada. What to notify about es un interruptor por tipo: un agente te necesita, un agente terminó, un comando largo terminó, actualizaciones instaladas. Push to your phone reenvía los mismos eventos a la app móvil de Deska, con Only when I’m away y un interruptor por categoría. Notificaciones cubre las categorías y cómo tocar una te lleva de vuelta al hilo correcto.
- Keybindings: reasigna cualquier acción a la combinación que prefieras, acotada al lugar donde debe aplicarse. Consulta la referencia de atajos de teclado para ver la lista completa de valores por defecto, las combinaciones reservadas y cómo se intercambian los conflictos automáticamente.
- Focus and stats: qué registra Deska sobre tu tiempo de concentración y qué te muestra de vuelta.
Remote access
Su propio grupo: Remote and mobile. El interruptor bajo This computer te permite llegar a las terminales, los agentes de código y los puertos de esta computadora desde la app móvil de Deska. Tus propias computadoras no necesitan ningún emparejamiento: activa el interruptor, inicia sesión en el teléfono con la misma cuenta y esta computadora aparece en su lista. La sección Push to your phone refleja los interruptores de notificaciones del teléfono.
Share this computer es una acción distinta para otro caso. Genera un código de un solo uso que da acceso a otra cuenta, y quienes lo aceptaron aparecen debajo con un botón Revoke. Todos los detalles en Acceso remoto.
Permissions and approvals
Todo lo que has dejado hacer a un agente en esta computadora, y cómo revertirlo. La sección Agent autonomy lleva un interruptor por cada CLI de agente lanzada en terminal que tenga un modo sin permisos, de modo que Claude Code ofrece Skip permissions y Codex ofrece Full auto. Activar uno implica que ese agente siempre se lanza en ese modo y actúa sin pedir confirmación. Los mismos interruptores aparecen en las tarjetas de agente de la Panel Library, y ambas superficies siempre coinciden.
Privacy and telemetry
Qué envía Deska a algún lado, y qué no envía nunca. Dos interruptores, ambos activados de fábrica y ambos desactivables: Send crash reports informa de errores no controlados de forma anónima, y Send anonymous usage data envía la versión de la app, el sistema operativo y los eventos de actualización, sin rutas de archivo, nombres de proyecto ni datos personales. Consulta Privacidad y tus datos para saber exactamente qué lleva cada uno.
Diagnostics
Una instantánea de soporte de solo lectura, y el primer sitio donde mirar cuando algo se comporta de forma extraña. Muestra la versión de Deska y su canal de publicación, las versiones de Electron, Chromium, Node y V8, tu plataforma y kernel, las rutas que necesita un informe de error (cada una con un botón Reveal), la última medición en caché de cada instancia de agente de código, el tamaño del registro de hilos de agente, y las variables de entorno de Deska activas en este proceso, solo por su nombre. La sección Reset devuelve cada preferencia a su valor por defecto; nunca toca tus archivos de proyecto.
Copy diagnostics copia exactamente lo que hay en pantalla como texto plano. No contiene nombres de cuenta, tokens ni claves de API, lo que hace que sea seguro pegarlo en un hilo de soporte.
Solución de problemas y preguntas frecuentes recorre los fallos que esta página ayuda a identificar.