App de escritorio y agente

Shara se usa a diario desde la app de escritorio. Es donde vive el chat con Amadeus, la bandeja de aprobaciones y las notificaciones nativas. Aparte, y solo si lo quieres, hay un agente que corre en tu máquina y ejecuta acciones ahí: son dos cosas distintas y se instalan por separado.

Qué es cada cosa

Pieza	Qué es	Cuándo la necesitas
App de escritorio	La aplicación con interfaz: chat, aprobaciones, ajustes, facturación.	Siempre. Es el cliente recomendado.
Agente de escritorio	Un servicio sin interfaz que corre en tu equipo y ejecuta lo que Amadeus le pide con acceso a todo tu perfil, dentro de las exclusiones de abajo.	Cuando quieras que los agentes actúen sobre tu propia máquina.
Server Agent	El equivalente para servidores sin nadie delante: un agente residente, sin interfaz, con el que los agentes leen el servidor. Los cambios piden la aprobación de un administrador. Los flujos no se lanzan solos: hoy corren con el botón Ejecutar o pidiéndoselo a Amadeus.	Entornos servidor.

Los tres están incluidos en todos los planes desde First. No son un extra de pago.

Instalar la app de escritorio

Descarga el paquete de tu sistema y ábrelo. Los enlaces llevan siempre a la versión vigente, así que no hay que buscar el número:

Sistema	Descarga	Formatos
Windows	Descargar para Windows	Instalador .exe de un clic. Crea acceso directo y entrada en el menú de inicio, y arranca al terminar.
macOS	Descargar para macOS	.dmg (y .zip) universal: el mismo paquete vale para Apple Silicon y para Intel.
Linux	AppImage · .deb · .rpm · pacman	.AppImage, .deb, .rpm y .pacman, todos para x64.

Un aviso que conviene dar por adelantado: los instaladores no están firmados con certificado de editor. La primera vez, Windows SmartScreen o Gatekeeper de macOS mostrarán una advertencia; hay que aceptar explícitamente para continuar. Es lo esperado, no una señal de que algo vaya mal. La confianza la da el origen de la descarga y el hash publicado junto al paquete.

En Linux, si usas el AppImage, ejecútalo tal cual. El binario suelto que sale de descomprimir el paquete no registra el enlace shara://, y sin eso el login desde el navegador no sabe volver a la aplicación.

Actualizaciones automáticas

La app comprueba si hay versión nueva contra updates.sharasaas.com y se actualiza sola. No hay que reinstalar a mano ni vigilar el número de versión.

Si tienes una instalación antigua apuntando a updates.aiginer.com, ese nombre está retirado. Reinstala desde el paquete actual y la app quedará apuntando al feed correcto.

Entrar: el login vuelve a la app

El inicio de sesión se hace en el navegador, en app.sharasaas.com, y al terminar la página te devuelve a la aplicación mediante el enlace shara://, que el instalador registra en los tres sistemas. Si el navegador te pregunta si quieres abrir Shara, dile que sí.

La doble verificación es opcional (la empresa puede exigirla a todo su equipo): si la tienes activada, ten a mano la app de autenticación. Detalle en Cuenta, equipo y accesos.

Sesiones activas

Desde Ajustes → Seguridad ves las sesiones abiertas de tu cuenta: dispositivo, dirección IP y ciudad aproximada de cada una, deducida de la conexión. Puedes cerrar el resto de sesiones desde ahí y dejar viva solo la que estás usando. Es lo primero que hay que hacer si sospechas que alguien ha entrado con tu contraseña.

El agente de escritorio

El agente es un servicio que corre en tu equipo y ejecuta lo que Amadeus le encarga. Se instala desde la propia app de escritorio, en Ajustes → Agente de escritorio, y queda registrado para arrancar solo al iniciar sesión:

Sistema	Cómo arranca solo
Windows	Tarea programada al iniciar sesión.
macOS	Un LaunchAgent en tu usuario.
Linux	Un servicio de usuario de systemd.

Qué puede hacer: por defecto el agente tiene acceso a todo tu perfil en el equipo. Puede leer, crear, editar, mover y borrar ficheros, ejecutar programas y scripts y controlar el navegador, siempre en el escritorio de la persona que habla con él. Los 21 agentes cuentan con herramientas de asistente de código mientras tu PC esté conectado.

Qué no toca: los almacenes de contraseñas y llaveros del sistema, las cookies y credenciales guardadas del navegador y las claves privadas SSH y GPG. Lo que borra con sus herramientas va a la Papelera y se puede recuperar mientras no la vacíes; escribir accesos directos del sistema y leer el portapapeles piden tu confirmación. Cada acción queda en un registro de actividad visible en la aplicación y en el registro de auditoría de la empresa.

También genera documentos de verdad (PDF, Word, Excel y PowerPoint) con la marca de tu empresa y monta vídeos con voz en off. El director de un departamento puede subir un documento de ejemplo como plantilla y Shara copia su estilo (hay 18 tipos de documento).

El token con el que el agente se identifica vive cifrado en tu equipo, y se renueva solo. No hay que copiar claves a mano más allá de la clave de activación del primer arranque.

Para servidores sin nadie delante existe el Server Agent, que es un paquete distinto con su propio instalador y su unidad de systemd. Los agentes leen el servidor entero (carpetas, ficheros, registros, Docker, servicios y comandos de consulta) sin pedir confirmación en cada lectura, salvo /etc/shadow, las claves privadas y los secretos de Docker. Cualquier cambio (reiniciar, instalar, editar) solo se ejecuta con la aprobación de un administrador de tu empresa en Shara, con el comando exacto que aprueba, y queda auditado. Solo habla con la API y con el servicio de actualizaciones si el certificado lo emite una de las autoridades raíz fijadas en el agente (las de Cloudflare). Se comprueba la firma de cada eslabón de la cadena; si no casa, no envía nada. La fijación no se puede apagar en producción.

Dictado por voz

El chat admite dictar en vez de escribir. El audio se envía a la infraestructura de transcripción de Shara, en la UE, y vuelve como texto que puedes editar antes de enviarlo. Es una función que la empresa activa o desactiva; si el botón del micrófono no aparece, es que está apagada.

Qué hacer si algo falla

• La app dice «Sin conexión». Comprueba que api.sharasaas.com es alcanzable desde esa red. Los cortafuegos corporativos que filtran salida son la causa habitual.
• El login no vuelve a la app. Estás ejecutando el binario suelto en vez del AppImage, o el enlace shara:// no quedó registrado. Reinstala desde el paquete.
• El agente aparece como parado. Ábrelo desde Ajustes → Agente de escritorio: la pantalla dice si el servicio está registrado y si está corriendo, y permite volver a arrancarlo.
• Windows o macOS avisan al abrir el instalador. Es la falta de firma. Continúa desde el propio aviso.

¿Sigue sin funcionar? Escribe a soporte@aiginer.com con tu sistema operativo y la versión que aparece en Ajustes → Acerca de.