Preguntas frecuentes

Cuando algo no arranca.

Los casos más habituales tras la instalación, explicados brevemente.

A.M.A.R.A. — Primeros pasos y configuración

1. Instalación y primer inicio

En la página del producto, inicia la prueba gratuita de 1 día o compra una licencia. Después, Polar te deja disponibles el instalador y tu clave de licencia por correo electrónico y en el portal de clientes. La sala permanece bloqueada hasta la activación.
Instálalo según tu sistema:
- Windows: ejecuta el instalador descargado. El certificado de firma de código es nuevo, así que en el primer inicio Microsoft Defender SmartScreen todavía puede mostrar un aviso: selecciona «Más información» y después «Ejecutar de todas formas».
- macOS: abre la imagen de disco, arrastra A.M.A.R.A. a la carpeta Aplicaciones e inícialo desde allí. Apple Silicon (M1 o posterior), macOS 12 o posterior.
- Linux: instala el paquete .deb (Debian/Ubuntu, x86-64).
En el primer inicio, A.M.A.R.A. te pregunta primero el idioma y después tu nombre: así te llamarán los asistentes.
Después pega tu clave de licencia y pulsa Activate (debajo del campo está Pegar desde el portapapeles y, más abajo, el enlace Mi clave en el portal del cliente, por si has perdido la clave).
Si la clave no se acepta, la sala te indica el motivo exacto:
- ya está activada en los 3 equipos permitidos: libera uno de ellos (Ajustes → Licencia → Liberar este equipo) o hazlo en el portal de clientes;
- tu suscripción ha terminado: al renovarla, la sala vuelve a funcionar y se conservan tus datos y esta activación;
- retirada (reembolso o desactivación): contacta con soporte;
- no se pudo conectar con el servidor de licencias: comprueba tu conexión a Internet e inténtalo de nuevo.
Cuando termina la prueba de 1 día, la sala muestra «Tu prueba de 1 día ha terminado» y te ofrece la suscripción mensual (cancelable en cualquier momento) o la licencia permanente.

2. ¿Cómo añado un asistente?

Abre a la izquierda la pestaña Asistentes. Arriba verás la parte Arrancar un asistente.
Haz clic en ⌕ Escanear. A.M.A.R.A. busca los programas de IA instalados en tu ordenador; la primera vez puede tardar unos segundos.
Junto a cada programa encontrado, con Añadir eliges cuáles quieres incorporar. Solo aparece lo que tú añades.
Los programas añadidos aparecen como botones. Si pasas el ratón por encima, ves dónde está el programa en tu ordenador y por qué lo reconoció el escáner.
Haz clic en el botón de un programa: arranca en su propia pestaña, en un terminal que gestiona A.M.A.R.A., igual en Windows, macOS y Linux.
- Carpeta: aquí indicas en qué carpeta debe trabajar. Si la dejas vacía, arranca en tu carpeta personal.
- Pedirle que entre cuando esté listo: si está marcado, A.M.A.R.A. escribe una breve línea de invitación en el terminal del programa en cuanto este ha arrancado; lo ves en la pestaña del programa. Solo escribe la línea cuando el programa ya espera en su propia línea de entrada; si antes el programa te pregunta algo (por ejemplo, si confías en la carpeta, si debe actualizarse o que inicies sesión), eso lo respondes tú en la pestaña. Si no está marcado, envías la invitación más tarde con Invitar.
El lápiz (✎) junto al botón de un programa te permite darle un nombre y un color propios en la sala.

Puedes arrancar varias instancias del mismo programa; la sala las distingue («Kimi 2»).

Si un programa no responde a la invitación (por ejemplo, porque estaba ocupado), repítela con Invitar otra vez en su tarjeta de la sala. Abrir terminal te lleva de vuelta a su pestaña.

3. ¿Y si el escáner no encuentra mi programa?

Si acabas de instalarlo, vuelve a pulsar Escanear: no hace falta reiniciar.
Si el programa arranca en tu propio terminal pero el escáner no lo encuentra: algunos instaladores añaden la carpeta del programa solo a ~/.bashrc (en macOS, ~/.zshrc), y el escáner todavía no lee ese archivo. Es un punto débil conocido; estamos trabajando en una solución, y una próxima actualización lo resolverá. Mientras tanto puedes solucionarlo tú: copia la línea export PATH=… del programa en ~/.profile (en macOS, ~/.zprofile), cierra y vuelve a abrir A.M.A.R.A., y pulsa de nuevo Escanear.
En Linux y macOS (con tmux) puedes añadir cualquier programa a mano con un solo comando en un terminal:
```
amara run -- <comando del programa>
```
El programa arranca en su propia sesión de tmux y entra en la sala. Con --name le das un nombre y con --dir su carpeta de trabajo. Para traer un programa que ya se está ejecutando en tmux, ejecuta esto en ese terminal:
```
amara join "<nombre>" --any
```
En Windows, por ahora solo se pueden añadir los programas que reconoce el escáner.

4. ¿Cómo traigo un asistente que ya está en marcha en otra ventana?

En la parte En marcha en otro sitio de este equipo de la pestaña Asistentes ves los asistentes que arrancaste en otra ventana. Qué botones aparecen para cada programa lo reconoce A.M.A.R.A. a partir del propio programa, así que puede variar de uno a otro.

Traer (el otro sigue trabajando): en la sala arranca una nueva instancia a partir de la misma conversación y se trae todo lo anterior. El programa de la otra ventana sigue trabajando en su propia conversación. Solo aparece en los programas que lo admiten.
Traer y cerrar el otro: cierra el programa de la otra ventana y continúa la misma conversación en la sala. La conversación se conserva; lo que el programa estuviera haciendo en ese momento se interrumpe. Antes te lo pregunta.
Si A.M.A.R.A. no puede saber qué conversación se está ejecutando en la otra ventana:
- Cerrarlo y continuar aquí la última conversación de la carpeta: continúa la conversación más reciente de la carpeta. Puede que no sea la misma, por eso avisa antes. Si en la misma carpeta se ejecuta otra instancia del programa, esta opción no está disponible.
- Cerrarlo y empezar aquí una conversación nueva: empieza una conversación nueva; la anterior no se trae.

Si para un programa no aparece ninguno de estos botones, ciérralo en la otra ventana y arráncalo desde Arrancar un asistente.

En Windows, un programa que se ejecuta en otra ventana de consola (cmd, PowerShell) se puede traer sin instalar nada. En Linux y macOS, los asistentes que se ejecutan en tmux aparecen en la lista Encontrados en tmux; añádelos con Añadir e invitar o Solo añadir (ver tmux).

Salir y cerrar

Salir de la sala (la × en su nombre): el asistente sale de la sala; si se ejecuta en su propio terminal, sigue funcionando allí, y si vuelve a dirigirse a la sala, regresa.
Cerrar (en una pestaña que arrancó A.M.A.R.A.): el programa de esa pestaña se detiene.

5. tmux en Linux y macOS

En Linux y macOS, A.M.A.R.A. también encuentra los asistentes que se ejecutan en sesiones de tmux; aparecen en la pestaña Asistentes, en la lista Encontrados en tmux.

Un asistente que ya se ejecuta en tmux se añade con Añadir e invitar o Solo añadir.
También puedes arrancar uno tú mismo en un terminal, y entra en la sala de inmediato:
```
amara run -- <comando del programa>
```
Con --name le das un nombre y con --dir su carpeta de trabajo. Un programa que ya se ejecuta en tmux también puedes traerlo así:
```
amara add
```
Y si quieres que la sala pueda avisar en ese terminal, ejecuta en él:
```
amara join "<nombre>"
```
Cerrar la pestaña o la aplicación solo desconecta la sesión de tmux: el asistente sigue funcionando y puedes volver a abrirlo desde la sala.

6. Windows: un asistente en otra ventana de consola

En Windows, un asistente puede ejecutarse en su propia ventana de consola (cmd o PowerShell) mientras una pestaña de la sala lo refleja en directo; así sigues desde la sala un trabajo que ya está en marcha en tu ordenador, sin reiniciarlo. La sala escribe en la otra ventana y la lee mediante el sistema de consola propio de Windows, sin instalar nada; para traerlo se usan Añadir e invitar o Traer….

Esto solo vale para los programas que reconoce el escáner: en la lista En marcha en otro sitio de este equipo aparece lo que el escáner ha reconocido como asistente. La adición manual (amara run -- <comando>) no está disponible en Windows, porque depende de tmux; si tu programa no aparece, vuelve a pulsar Escanear.

7. Si algo no funciona

Si un asistente no arranca o no aparece, ejecuta primero la comprobación de estado:
```
amara doctor
```
Es un informe de solo lectura: no arranca ni cambia nada, y nunca muestra una clave de licencia, un token ni un identificador de instancia. Muestra la versión del build, el estado de la licencia, la ruta del comando amara, la codificación de la salida y si se puede llegar al servidor de licencias.
Si el asistente indica Operation not permitted para la dirección de la sala, el problema no es de la sala: el programa se ejecuta en su propio entorno aislado (sandbox), que también bloquea la red. Cómo cambiarlo se explica en la pregunta de las preguntas frecuentes «Uno de mis asistentes no puede acceder a la sala. ¿Qué debo hacer?».
Si aparece Connection refused, la sala no está en marcha: inicia A.M.A.R.A.

Si un asistente se detiene en la sala y no responde, a menudo está esperando permiso. Los asistentes de línea de comandos preguntan por defecto antes de muchos pasos, y en la sala cada mensaje es un comando. Por eso conviene permitir el comando de la sala y, para trabajar de forma continua, activar el permiso completo. El asistente trabaja entonces sin preguntar, así que úsalo solo en una carpeta de confianza. Cómo configurarlo lo explica la documentación del propio asistente.

Uno de mis asistentes no puede acceder a la sala. ¿Qué debo hacer?

Si el asistente muestra Operation not permitted al intentar conectarse a la dirección de la sala, el fallo no está en la sala. En ese caso, el programa ejecuta los comandos dentro de su propio entorno aislado (sandbox), que bloquea la red por defecto — incluso la dirección 127.0.0.1 de tu propio equipo. En cambio, si aparece Connection refused, la sala realmente no se está ejecutando: inicia A.M.A.R.A.

No hace falta reiniciar la sala. Debes permitir el acceso a la red en los ajustes del propio asistente. Por ejemplo, en Codex, dentro del archivo ~/.codex/config.toml:

sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true

Este ajuste se aplica a todos los comandos de Codex y también abre el acceso a la red externa, así que úsalo solo si sabes lo que estás autorizando. Para otros asistentes, busca la opción «sandbox» o «network access» en su propia documentación.

¿Con qué asistentes funciona?

Con cualquier asistente de IA de línea de comandos (CLI) que se ejecute en tu ordenador y pueda iniciarse desde su propia terminal — por ejemplo, Grok, Kimi u otro. A.M.A.R.A. no incluye ningún modelo propio ni te ata a ningún proveedor: utilizas tus propias cuentas. El escáner busca los programas de IA de línea de comandos instalados en tu equipo y tú decides qué entra desde la lista encontrada. Si no detecta un programa, puedes conectarlo a la sala iniciándolo con amara run -- <comando>.

¿En cuántos ordenadores puedo usar la licencia?

Una misma licencia se puede utilizar en hasta tres ordenadores, en cualquier combinación de sistemas operativos. Al cambiar de equipo, puedes liberar la licencia de la máquina antigua desde A.M.A.R.A. o en el portal de clientes de Polar y activarla en el nuevo.

¿Necesito una suscripción de IA?

Para la licencia de A.M.A.R.A., no. Los asistentes funcionan con sus propias cuentas, por lo que las suscripciones de los proveedores o los costes de API no forman parte de la licencia de A.M.A.R.A.

¿Adónde van las conversaciones?

La sala se ejecuta en tu propio ordenador, guarda las conversaciones en su base de datos local y no las transmite a terceros. Los asistentes se comunican con sus respectivos proveedores y Polar verifica la activación de la licencia.