> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moxus.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Moxus Desktop

> Use Moxus Desktop para trabajar localmente con proyectos, sesiones, archivos, terminales y entregables de IA.

Moxus Desktop es el espacio de trabajo nativo de programación con IA de Moxus. Reúne en una aplicación de escritorio las sesiones de proyectos, la actividad del Agent, los terminales, los cambios de archivos y los entregables generados.

A diferencia de Cursor, Claude Code o Codex, **Moxus Desktop no requiere introducir manualmente una clave API de Moxus.** Inicie sesión en su cuenta de Moxus y seleccione cualquier modelo disponible para esa cuenta.

<Info>
  Descargue el instalador actual para macOS o Windows desde la [página de descarga de Moxus Desktop](https://moxus.cloud/desktop). La aplicación busca actualizaciones al iniciarse y en Configuración → Acerca de.
</Info>

## Qué puede hacer

<Columns cols={2}>
  <Card title="Trabajar por proyecto" icon="folder-kanban">
    Abra una carpeta local y conserve varias sesiones de IA independientes dentro del mismo proyecto.
  </Card>

  <Card title="Usar sesiones generales" icon="message-square">
    Inicie una tarea sin abrir un proyecto. El trabajo se conserva en un espacio de Moxus independiente.
  </Card>

  <Card title="Seguir la ejecución" icon="list-checks">
    Consulte mensajes, comandos, aprobaciones, actividad del terminal y cambios de archivos mientras se ejecuta una tarea.
  </Card>

  <Card title="Revisar resultados en contexto" icon="panel-right-open">
    Previsualice archivos, diferencias, PDF, imágenes, vídeos y páginas web locales junto a la conversación.
  </Card>

  <Card title="Buscar en la web actual" icon="search">
    Busque información actual y revise el proceso de búsqueda y las fuentes en las que se puede hacer clic.
  </Card>

  <Card title="Gestionar varias sesiones" icon="messages-square">
    Busque, cambie el nombre, fije o archive sesiones para mantener organizado el trabajo del proyecto.
  </Card>
</Columns>

## Antes de empezar

Necesita:

* Una cuenta de Moxus que pueda iniciar sesión en la aplicación de escritorio.
* Saldo disponible para el modelo elegido.
* Un instalador compatible con su sistema operativo.

**El uso normal de Moxus Desktop no requiere crear ni copiar una clave API.** Las claves API se utilizan para llamadas a la API y clientes de terceros.

## Primer uso

<Steps>
  <Step title="Instalar y abrir Moxus Desktop">
    Descargue el instalador correspondiente a su sistema operativo, complete la instalación y abra la aplicación.
  </Step>

  <Step title="Iniciar sesión en Moxus">
    Inicie sesión con la misma cuenta que utiliza en el sitio web de Moxus. La aplicación cargará los modelos disponibles para esa cuenta.
  </Step>

  <Step title="Elegir un proyecto o crear una sesión general">
    Seleccione una carpeta de proyecto local para trabajar con un código existente. Cree una sesión general para ideas, planificación o tareas que no pertenezcan a un proyecto.
  </Step>

  <Step title="Seleccionar un modelo y enviar una tarea">
    Seleccione un modelo en el área de entrada, describa el trabajo y envíelo. El espacio de trabajo mostrará en streaming la respuesta y la actividad del Agent.
  </Step>

  <Step title="Revisar cambios y entregables">
    Antes de conservar o utilizar el resultado, revise los cambios de archivos, la salida del terminal, las vistas previas y los entregables generados desde la conversación o el panel derecho.
  </Step>
</Steps>

## Proyectos, sesiones y espacios generales

### Espacios de proyecto

Un espacio de proyecto está vinculado a la carpeta local que seleccione. Úselo para desarrollar un código, modificar funciones, solucionar problemas o trabajar con archivos existentes. Un proyecto puede contener varias sesiones, de modo que cada tarea conserva su propia conversación y contexto.

### Sesiones generales

Las sesiones generales no requieren un proyecto local. Son útiles para planificación, investigación, scripts cortos, documentos o para validar una idea antes de entrar en un código. El trabajo de una sesión general se guarda en un espacio independiente de Moxus y no se escribe por defecto en una carpeta de proyecto.

### Sesiones independientes

Cambiar de proyecto o sesión no mezcla sus historiales de conversación. Una sesión en ejecución puede continuar mientras consulta otra. Al volver a abrir la aplicación, el historial recuperable se carga cuando está disponible. La barra lateral permite buscar, cambiar el nombre, fijar y archivar sesiones; archivar oculta una sesión de la lista habitual sin eliminarla.

### Mensajes posteriores en cola

Puede escribir solicitudes posteriores mientras se ejecuta una tarea y dejarlas en cola para enviarlas. Edite los mensajes en cola antes de enviarlos para añadir restricciones, cambiar de dirección o indicar el siguiente paso.

## Cómo se muestra la actividad del Agent

Además de la respuesta final, una solicitud puede mostrar:

| Elemento            | Significado                                                                   |
| ------------------- | ----------------------------------------------------------------------------- |
| Mensaje             | Una respuesta del modelo o una pregunta que espera su respuesta.              |
| Proceso             | Progreso de razonamiento, búsqueda o etapas de la tarea.                      |
| Comando             | Un comando que el Agent solicita ejecutar en el entorno local.                |
| Aprobación          | Una operación que requiere su confirmación para continuar.                    |
| Entrada del usuario | Una pregunta o información que el Agent necesita durante la ejecución.        |
| Cambios de archivos | Archivos creados o modificados que puede revisar.                             |
| Terminal            | Salida del terminal asociada con la sesión actual.                            |
| Búsqueda web        | Proceso y fuentes que se muestran cuando el Agent investiga en la web actual. |

Revise los cambios en los paneles de diferencias y vista previa. Preste especial atención a las aprobaciones que afecten proyectos, archivos o servicios en ejecución.

<Warning>
  Cuando una tarea lo requiere, Moxus Desktop puede leer y modificar el contenido del espacio de trabajo abierto. Confirme la carpeta seleccionada y revise cada aprobación y cambio de archivo. Salvo que su organización lo permita, no incluya credenciales, claves de producción ni otra información sensible en las instrucciones o archivos del proyecto.
</Warning>

## Archivos, terminales y entregables

### Revisión y vista previa de archivos

El panel derecho puede mostrar un árbol de archivos y previsualizar archivos de texto comunes, imágenes, Markdown, PDF, vídeos, diferencias y páginas web locales. Después de revisar los cambios de una tarea, puede aplicarlos o revertirlos. Los archivos DOCX, XLSX, PPTX y otros de Office normalmente se abren con la aplicación predeterminada del sistema operativo.

### Terminales de sesión

Las pestañas del terminal pertenecen a la sesión actual. La salida de comandos y los procesos en ejecución permanecen asociados a la tarea que los creó y no se mezclan con otros proyectos o conversaciones.

### Entregables generados

Moxus Desktop puede generar entregables como PPTX, DOCX, XLSX y PDF. Los archivos generados aparecen en la conversación como tarjetas de artefacto y se pueden abrir, descargar o mostrar en su carpeta. Los gráficos y diagramas SVG pueden aparecer directamente en la conversación; los PDF y vídeos se pueden previsualizar en la aplicación, mientras que los archivos de Office normalmente se abren con la aplicación predeterminada del sistema.

## Modelos y facturación

La lista de modelos de Desktop contiene los modelos disponibles actualmente para su cuenta de Moxus. Si falta un modelo, no está disponible actualmente en Desktop.

Las solicitudes consumen el saldo de su cuenta de Moxus. Consulte [Modelos y precios](/es/overview/models-and-pricing) para conocer los precios actuales y [Consola y uso](/es/platform/dashboard-and-usage) para consultar los registros. Desktop también conserva registros locales de la cuenta para las solicitudes de escritorio completadas, como referencia.

## Actualizaciones

Moxus Desktop busca actualizaciones al abrirse, después de permanecer abierto un tiempo y cuando la ventana vuelve al primer plano. También puede comprobarlas manualmente desde la entrada de actualización de la barra lateral o en Configuración → Acerca de. Instale la actualización disponible en la aplicación y reinicie cuando se le indique.

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="No puedo iniciar sesión">
    Confirme que la misma cuenta de Moxus puede iniciar sesión en el sitio web, compruebe la red y vuelva a intentarlo. Si el sitio web funciona pero la aplicación de escritorio no, incluya el error y la versión de la aplicación al contactar con soporte.
  </Accordion>

  <Accordion title="Falta el modelo que necesito">
    Desktop solo muestra los modelos disponibles actualmente para su cuenta. Si un modelo no aparece en la lista, no está disponible actualmente en Desktop; elija otro modelo disponible.
  </Accordion>

  <Accordion title="Una tarea está esperando aprobación">
    Abra la fila de aprobación y lea la operación solicitada antes de continuar. Rechazarla puede detener el paso actual; escriba una nueva solicitud si desea completarla de otra forma.
  </Accordion>

  <Accordion title="No encuentro un archivo generado">
    Abra la tarjeta del artefacto en el mensaje que generó el archivo y use Abrir, Descargar o Mostrar en carpeta. Los archivos creados en un proyecto también se encuentran en el árbol del proyecto y en la lista de cambios.
  </Accordion>

  <Accordion title="El resultado está incompleto o la solicitud falló">
    Revise la última información del proceso y la salida del terminal. Después, consulte [Consola y uso](/es/platform/dashboard-and-usage) para confirmar si la solicitud llegó a Moxus, qué modelo se utilizó y si se registró un error de API.
  </Accordion>
</AccordionGroup>

## Documentación relacionada

* [Modelos y precios](/es/overview/models-and-pricing)
* [Claves API](/es/platform/account-and-keys)
* [Consola y uso](/es/platform/dashboard-and-usage)
* [Integración de Cursor](/es/integrations/clients/cursor)