Solución de problemas y preguntas frecuentes

Settings, Diagnostics es una instantánea de solo lectura con todo lo que necesita una respuesta de soporte: la versión de Deska y su canal de publicación, las versiones de Electron, Chromium, Node y V8, tu plataforma y kernel, las seis rutas en disco que importan, desde la carpeta de datos de aplicación hasta los worktrees de agentes (cada una con un botón Reveal para abrirlas), la última medición en caché de cada instancia de agente de código, y el tamaño del registro de hilos de agente.

Copy diagnostics copia todo eso como texto plano. No lleva nombres de cuenta, tokens ni claves de API, así que es seguro pegarlo en un correo o en un issue. Adjuntarlo convierte la mayoría de las idas y venidas en una sola respuesta.

Dex funciona con tu propio agente de código (Claude Code, Codex u opencode), con o sin sesión iniciada en Deska, así que las comprobaciones son sobre el motor y no sobre tu cuenta:

• ¿Hay una CLI de agente instalada y con sesión iniciada? Settings, AI capabilities, Dex muestra qué agente te responde y su estado actual. Si ninguno está listo, instala uno desde la Panel Library o completa su inicio de sesión; la siguiente sección cubre los fallos más habituales.
• La voz es la única excepción. Solo la voz necesita una cuenta de Deska y minutos restantes, y se pausa cuando se agotan los minutos del mes. Comprueba el saldo en tu panel de cuenta. Consulta Planes y facturación.

Claude Code, Codex y opencode son herramientas de línea de comandos independientes que Deska dirige; no vienen incluidas. La forma más sencilla de instalar una es la Panel Library (Cmd/CtrlShiftE): abre la tarjeta del agente, elige instalarlo y Deska ejecuta el comando de instalación por ti en una terminal. Cada herramienta gestiona su propio inicio de sesión.

Cuando un agente ya configurado se niega a arrancar, casi siempre es una de estas:

• El binario no está en tu PATH. Por defecto Deska busca claude, codex y opencode por su nombre. Si instalaste alguno en un sitio que tu shell de inicio no exporta, la instancia aparece como Not installed y la sesión no llega a arrancar.
• Una provider instance lo está sustituyendo. Cada instancia en Settings, Coding agents, Instances puede fijar su propia ruta de binario y su directorio home. Una ruta que era correcta en tu máquina anterior, o un home que pertenece a otra cuenta, produce exactamente el mismo fallo que un binario ausente. Borra la sustitución para volver a la búsqueda por defecto.
• La CLI tiene la sesión cerrada. Deska comprueba las credenciales de cada instancia y muestra el resultado en su fila. Una comprobación que vuelve sin autenticar significa que la herramienta necesita iniciar sesión, no Deska. Ejecuta la CLI una vez en un panel de terminal y completa su inicio de sesión.
• La CLI es demasiado antigua. Cada driver tiene una versión mínima. Activa CLI update checks y la fila de la instancia muestra el comando de actualización exacto según cómo se instaló ese binario, con un botón para ejecutarlo en una terminal.

Agentes de código cubre las instancias, los modos de ejecución y lo que espera cada driver.

Una sesión sin turno activo y sin nada pendiente de ti se cierra tras 30 minutos de inactividad. Es deliberado: si no, las CLI ociosas retendrían procesos, puertos y memoria durante toda la vida de la app. El hilo no se pierde. Aparece como detenido, no como fallido, y el siguiente mensaje que envíes retoma la conversación donde se quedó.

Una insignia de error es otra cosa. Esas llevan un motivo (el proceso no pudo lanzarse, se rechazaron las credenciales, la CLI está por debajo de la versión mínima, se cerró el transporte, o el proveedor nunca respondió) y necesitan alguna de las soluciones de arriba. Consulta Hilos de agente.

Cuando un hilo obtiene su propio worktree de git, Deska ejecuta una sola vez en el nuevo checkout el primer script marcado con runOnWorktreeCreate en el deska.json de tu proyecto, para que el agente nunca empiece en un árbol a medio instalar. Ese enganche es, por diseño, de mejor esfuerzo.

• Sin manifiesto no pasa nada. Un proyecto sin deska.json simplemente no ejecuta nada.
• Un manifiesto mal formado degrada a advertencia. Las claves desconocidas se ignoran y las entradas incorrectas se omiten, cada una con una advertencia que aparece como actividad del hilo. Un archivo escrito a mano nunca puede bloquear la creación de un hilo.
• Los scripts largos tienen un tope de 10 minutos. Las instalaciones de dependencias tardan minutos, así que el tope es generoso, pero un script colgado se termina en vez de retener para siempre el primer turno del hilo. Se guarda el final de su salida combinada para que veas el motivo.
• Un fallo es una advertencia, no un hilo bloqueado. El hilo se abre igualmente. Lee la salida registrada, arregla el script, y borra y vuelve a crear el hilo para ejecutarlo de nuevo.

Si al pulsar el atajo de voz no ocurre nada, o no vuelve nada, comprueba:

• Permiso del micrófono. Deska necesita acceso a tu micrófono. Concédeselo en los ajustes de privacidad de tu sistema operativo y vuelve a intentarlo.
• El atajo correcto. El dictado es CmdShiftV en macOS y CtrlAltV en Windows y Linux. Es global, así que funciona incluso cuando Deska está en segundo plano.
• Minutos e inicio de sesión. La voz gestionada necesita una cuenta y gasta minutos; si falta alguno de los dos, el dictado se pausa. Consulta Voz.

Sí, para eso sirve el acceso remoto. Con tus propias máquinas no hay nada que emparejar: activa Settings, Remote Access en el escritorio, inicia sesión en el teléfono con la misma cuenta de Deska y esta computadora aparece en su lista. Desde ahí puedes engancharte a terminales que ya están corriendo, seguir hilos de agentes de código y responder a sus aprobaciones, previsualizar un servidor de desarrollo y hablar con Dex.

Los códigos de un solo uso existen para otra cosa. Share this computer genera un código que da acceso a otra cuenta a esta máquina, y puedes revocar ese acceso más tarde desde la misma página. Si tu teléfono no lista una computadora, comprueba que el escritorio esté despierto, con sesión iniciada en la misma cuenta y con el interruptor de Remote Access activado.

El plan gratuito se conecta desde un dispositivo cliente a la vez, así que iniciar sesión en un teléfono o navegador nuevo ofrece cerrar la sesión del anterior; aceptar es un toque y el dispositivo viejo simplemente te pide iniciar sesión de nuevo. El límite de computadoras es aparte: cuenta las máquinas que has vinculado, y el plan gratuito permite tres cambios de computadora por periodo. Cuando un cambio se rechaza, el mensaje muestra la fecha en la que se restablece el cupo.

Los planes de pago levantan el límite de computadoras. Consulta Planes y facturación.

Iniciar sesión abre tu navegador, y el navegador devuelve el resultado a la app de escritorio mediante un enlace deska://. Ese traspaso depende de que tu sistema operativo sepa qué app es dueña del esquema, algo que puede romperse tras mover Deska de carpeta, tener dos instalaciones a la vez o usar una compilación de desarrollo sin empaquetar. Si el navegador dice que iniciaste sesión pero la app sigue mostrando Not signed in, cierra Deska por completo, ábrela desde su ubicación instalada y vuelve a iniciar sesión desde Settings, Account. En Windows y Linux el enlace llega como un segundo arranque de la app, así que una Deska a la que se le impide volver a arrancar se lo tragará en silencio.

Deska busca versiones nuevas por su cuenta, pero nunca descarga ninguna a tus espaldas. El flujo es:

1. Una comprobación en segundo plano encuentra una versión y aparece una tarjeta.
2. Haces clic en Download. La descarga corre con un indicador de progreso visible.
3. Haces clic en Restart now para instalarla de inmediato. Si prefieres no interrumpir tu trabajo, no hagas nada: una descarga terminada se instala la próxima vez que cierres Deska.

Los mismos estados viven en Settings, Updates, donde el botón dice Check for updates, Download v…, una etiqueta de progreso, y finalmente Restart to update. Esa página también contiene las notas de la versión y el selector de Release channel. Puedes forzar una comprobación cuando quieras desde Help, Check for Updates….

Los canales, las notas de versión y lo demás se explican en Actualizaciones.

• La descarga se atasca o se reinicia. Suspender la máquina o perder la red puede matar una descarga en silencio, así que Deska vigila el progreso y reinicia la descarga por su cuenta, hasta unos cuantos intentos. Si se rinde, la tarjeta se convierte en un enlace de descarga manual.
• El reinicio no hace nada. Si el traspaso al instalador no prospera en unos 30 segundos, Deska deja de esperar y ofrece la descarga manual en lugar de dejarte con un botón muerto. Coge el instalador desde el enlace e instálalo encima; tus ajustes y espacios de trabajo quedan intactos.
• Se ofrece la actualización pero falta el archivo. Las versiones se publican por sistema operativo de forma independiente, así que una versión puede estar descargable en macOS mientras la compilación de Windows aún se sube. Deska te dice que la compilación para tu plataforma está en camino en lugar de ofrecerte un enlace que fallaría. Vuelve a comprobarlo en un rato.
• macOS se niega a abrir una compilación descargada a mano. Si macOS dice que la app está dañada o que viene de un desarrollador no identificado, la descarga arrastra una marca de cuarentena. Bórrala con xattr -cr /Applications/Deska.app y vuelve a abrir la app.
• Windows avisa sobre el instalador. Los instaladores están firmados desde la 0.13.0, así que un aviso de SmartScreen significa que estás ejecutando una descarga antigua. Consigue la actual en la página de descarga.

• Atajos: restablece combinaciones sueltas o todas ellas en Settings, Keybindings.
• Todos los ajustes: Settings, Diagnostics, Reset contiene Reset all settings, que devuelve cada preferencia a su valor por defecto. No toca tus archivos de proyecto.
• ¿Perdiste el recorrido de bienvenida? Repítelo desde Settings, Getting started, Show onboarding tour.

Usa Help, Report Issue… en la app, o escribe a [email protected] y te ayudaremos. Pega la salida de Copy diagnostics en tu mensaje y normalmente podremos responder a la primera.