Documentación de AI Coach

Esta es la guía oficial para usar AI Coach, la mascota de escritorio con IA para macOS. Abarca desde la crianza del huevo, la transcripción de voz, herramientas como el lanzador circular y las notas, la generación de imágenes y voz con IA, la integración con Claude y la Conexión P2P, hasta la configuración de la API de OpenAI y la API de Gemini.
Si es tu primera vez, te recomendamos leer desde "1. Primeros pasos" en orden.

Esta documentación corresponde a AI Coach v1.0.3. Las especificaciones pueden cambiar en futuras actualizaciones.

---

1. Primeros pasos

Qué es AI Coach

AI Coach es un personaje de IA que vive de forma permanente en tu escritorio.
Incluye todo lo necesario: entrada de voz, IA y pequeñas herramientas que te ayudan a trabajar. Pero su característica principal es que se cría desde un huevo. Según cómo lo uses, cambiará la forma en la que crece.

Aunque el personaje ya no esté, las funciones principales —transcripción de voz, IA y las utilidades— siguen funcionando igual. Solo que tu escritorio se sentirá un poco más solo.

Instalación

macOS

1. Abre el archivo .dmg que descargaste y arrastra AI Coach.app a la carpeta "Aplicaciones".
2. La primera vez, ábrelo con clic derecho → "Abrir".
3. La mascota aparecerá en la parte inferior derecha del escritorio y se agregará un icono en la barra de menús. No aparecerá ningún icono en el Dock (funciona como una aplicación de barra de menús).

Windows

La versión para Windows está en desarrollo y llegará próximamente. Todavía no se distribuye ningún instalador; los pasos siguientes se aplican cuando se publique.

1. Ejecuta el instalador (AICoach-Setup-x.x.x.exe).
2. Después de la instalación, ábrelo desde el menú Inicio.
3. Se agregará un icono en la bandeja del sistema.

Modo de prueba (30 días)

Solo la primera vez que instalas la aplicación, puedes elegir empezar en el "modo de prueba" de 30 días. En el primer inicio, después de una explicación en una pantalla negra, eliges entre "Empezar la prueba", "Empezar desde el huevo" y "Volver a escuchar".

¿Qué puedo hacer durante la prueba?

Junto a Robo, tu compañero robot, puedes usar casi todas las funciones antes de criar a nadie. Lo único que no puedes usar son los juegos de "Juegos" que se descargan al aprenderlos. Comprar, incubar y criar huevos queda en pausa durante la prueba.

¿Qué pasa con Robo?

• No crece, no envejece y nunca se va por enfermedad ni por llegar al final de su vida
• El estado de Robo no se guarda ni se sincroniza. Cada vez que reinicias la aplicación, vuelve a como empezó
• Las notas y los archivos que crees durante la prueba no se borran

¿Qué necesito para empezar?

• Iniciar sesión con Apple o con Google
• Solo se puede usar una vez por cuenta
• Solo funciona en el Mac en el que empezaste la prueba

¿Dónde veo cuántos días quedan?

Al principio del menú aparece "Modo de prueba (quedan N día(s))". Desde ahí puedes consultar cuándo termina, leer la explicación o elegir "Terminar el modo de prueba y empezar desde un huevo…". Te avisa cuando quedan 7, 3 y 1 días.

¿Qué pasa cuando termina?

• Cuando pasan los 30 días o la terminas tú, la aplicación se reinicia y empiezas desde el primer huevo (el huevo gratuito de siempre)
• Las funciones se vuelven a aprender mientras crías a tu compañero
• Una vez terminada, nunca podrás volver a la prueba. Si eliges "Empezar desde el huevo", tampoco podrás empezar la prueba más adelante

¿Y si cerré la presentación?

Puedes volver a ella desde "Información del modo de prueba…" en el menú.

Permisos necesarios

La aplicación funciona aunque no concedas los permisos. Solo quedarán sin uso las funciones correspondientes (si no los concedes, la obtención de texto simplemente vendrá vacía; no se producirá ningún fallo).

Iniciar automáticamente al iniciar sesión

• macOS: Barra de menús → Configuración → "Iniciar al iniciar sesión"
• Windows: Bandeja del sistema → "🔄 Iniciar al iniciar sesión"

Salir

• macOS: Barra de menús → "Salir de AI Coach", o Cmd + Q
• Windows: Salir desde el menú de la bandeja del sistema

Cuando quieras un rato de silencio, puedes guardar al personaje con "Ir a casa" en el menú del clic derecho.

---

2. El huevo y tu primer compañero

Recibir un huevo

Al descargar la aplicación, viene incluido tu primer huevo. No hace falta hacer nada para recibirlo.

Puedes comprar huevos adicionales en el sitio web (→ "10. Comprar huevos"). Los huevos comprados llegan a la Bandeja de incubación.

Bandeja de incubación

La Bandeja de incubación muestra la cantidad de huevos que aún no has incubado.

• macOS: Barra de menús → "Bandeja de incubación"
• Windows: Bandeja del sistema → indicador de existencias

Al presionar "Criar", se consume un huevo y este queda colocado en el escritorio.

Hasta que nazca

El huevo crece solo con el paso del tiempo. No puedes alimentarlo.

• Al cabo de un rato aparecerán grietas en el cascarón y, con el tiempo, nacerá.
• El tiempo transcurrido también cuenta mientras la aplicación está cerrada.
• Mientras es huevo no habla. Tampoco camina. Cuando tiene hambre, tiembla un poco.
• El huevo no puede enfermar ni morir. Puedes esperarlo con tranquilidad.

Limitaciones mientras es un huevo (por diseño): la entrada de voz, el historial del portapapeles, los marcadores, el lector de RSS y el horóscopo aún no están disponibles mientras es un huevo. A partir del momento en que eclosiona y se convierte en bebé, se van desbloqueando por orden a medida que crece. Las notas y las tarjetas de crecimiento se pueden usar desde que es un huevo. El huevo tarda alrededor de una hora en eclosionar, y el tiempo también avanza con la aplicación cerrada.

Cuando nazca, aparecerá un cuadro de diálogo para ponerle un nombre. Puedes cambiar el nombre más adelante (clic derecho → "Cambiar el nombre").

Una escena solo para el primer inicio

Si abres la aplicación por primera vez sin datos guardados, verás una escena breve: una luz que titila en los márgenes oscuros, un huevo que aparece y una narración. Esta escena ocurre una sola vez.

---

3. Criar

Qué puedes hacer

Si haces clic derecho sobre el personaje, verás las acciones disponibles en ese momento.

También puedes tomarlo con el mouse para moverlo, o soltarle archivos para que se los coma. Las opciones que más uses también se pueden abrir desde el lanzador circular, que aparece al mantener presionada la tecla fn (→ "6. Utilidades").

Los tres deseos

El personaje tiene tres deseos: "tengo hambre", "tengo sueño" y "me siento solo". Cuando un deseo aumenta, te lo hará saber.

La soledad es un poco especial. No se alivia con comida ni con sueño.

• Llevarlo a pasear o tomarlo con el mouse — la soledad disminuye (el paseo funciona mejor)
• Cuidarlo — la soledad desaparece por completo
• Lanzarlo — la soledad aumenta
• Mientras tengas dos o más en pantalla al mismo tiempo, la soledad no se acumula. Cuando intercambian emojis en buena sintonía, la soledad también disminuye

Si respondes a un deseo en menos de 30 segundos desde que lo expresa, se alegrará aún más.

Condición física

• HP: si llega a 0, su vida termina. Jugar aumenta su valor máximo
• Saciedad: si se mantiene en 0, el HP sigue bajando
• Fatiga: se acumula con las acciones y se recupera durmiendo
• Inmunidad: sube si lo mantienes bien alimentado y sin cansancio. Si es baja, la enfermedad avanza
• Enfermedad: al avanzar, se resiste a pasear y pierde el apetito. Si empeora, deja de hablar por su cuenta

Si abres la aplicación después de 8 horas o más, hay una bonificación que recupera la inmunidad.

La forma de criarlo se vuelve su forma

"El que jugó mucho", "el que estudió mucho", "el que recibió mucho mimo": según cómo pase el tiempo, cambian los parámetros que desarrolla, y eso determina su forma al llegar a adulto.

No sabrás qué forma tomará hasta que sea adulto.
Si te contáramos todo lo que puede aparecer, se perdería la sorpresa, así que aquí lo dejamos en secreto.

Personalidad y forma de hablar

El personaje observa tus reacciones y va cambiando su forma de hablar.

El que consiguió lo que quería con mimos se volverá bueno para mimar; el que logró negociar con argumentos hablará como un compañero de igual a igual. Dar lástima, proponer un trato, halagarte, o simplemente portarse adorable: todas son maneras propias de decir "quiero que me mires otra vez".

También cambia según la etapa de crecimiento. El bebé balbucea, el niño pequeño con frases cortas, el chico o la chica con oraciones completas, y el adulto elige bien sus palabras.

---

4. El crecimiento y lo que viene después

Etapas de crecimiento

Huevo → Bebé → Infancia → Chico/Chica → Adulto

A medida que avanzan las etapas, puede hacer más cosas. En la etapa de chico/chica empieza a surgir el amor, y de adulto ya puede casarse y poner huevos. Junto con esto, las utilidades se van desbloqueando poco a poco en forma de "¡lo aprendí!".

Después de eclosionar, solo crece mientras la aplicación está abierta y el personaje está en pantalla. Un minuto equivale a una hora dentro del juego, y pasar de huevo a adulto lleva unas 17 horas con la aplicación abierta (42 días dentro del juego).

Mientras está guardado (dormant) y mientras la aplicación está cerrada, el tiempo no avanza. Piénsalo como una hibernación.

¿Cuántos puedo criar?

• Puedes tener hasta 6 en pantalla al mismo tiempo (hasta 8 contando los huevos)
• No hay límite en la cantidad que puedes guardar
• La administración está en la barra de menús de macOS → "🐣 Administrar personajes"; en Windows, desde la bandeja del sistema

Vivir juntos

Si tienes dos o más en pantalla al mismo tiempo, se acercarán y se alejarán entre sí, conversarán y se comunicarán sus sentimientos con emojis. También pueden hacerse buenos amigos o pelearse.

Cuando un chico y una chica adultos están cerca, puede surgir el amor de forma natural. No puedes "casarlos" tú. Es algo que ellos mismos eligen.

Los dos que se vuelven pareja pueden poner un huevo si se dan las condiciones. Poner un huevo es un acto en el que se entrega parte del tiempo que le queda (su HP máximo) a la siguiente vida. En el huevo que nace queda grabado el linaje de 3 generaciones.

Puedes consultar el árbol genealógico en la barra de menús de macOS → "👪 Ver árbol genealógico".

El final de la vida

Cuando el HP llega a 0, ese pequeño se convierte en fantasma.

Justo antes de convertirse en fantasma, recuerda los días que pasó contigo y se duerme dando las gracias por aquello que más compartieron.

El fantasma permanece con una figura semitransparente. No le da hambre, no enferma y no tiene un tiempo de vida. No puede enamorarse ni poner huevos. Puedes guardarlo y también volver a llamarlo.

Cuando estés listo para dejarlo ir, puedes elegir "Despedirlo". Tras una confirmación, volverá a los márgenes. Retenerlo o dejarlo ir: las dos son formas de querer.

Aun después de despedirlo, su registro permanece en la Enciclopedia.

Enciclopedia

Aquí se van reuniendo las formas que has encontrado, los registros de los que has criado y los días que vivieron.
Las formas que aún no has encontrado tienen su casilla oculta. Te invitamos a descubrir qué se esconde ahí.

---

5. Voz e IA

Hablar con el Shift derecho

Mientras mantengas presionado el Shift derecho durante 0,3 segundos o más, tu voz se convierte en texto. Al soltarlo, se detiene.
Si presionas el Shift derecho dos veces rápidamente (en menos de 0,4 segundos), puedes activar y desactivar la grabación sin mantenerlo presionado.

• Durante la grabación, el globo de diálogo muestra la forma de onda y el texto que se está reconociendo
• El resultado puede escribirse directamente en la aplicación activa en ese momento (la escritura automática se puede activar y desactivar en la configuración)
• También puedes soltar archivos de audio sobre el personaje para transcribirlos (macOS)
• Si registras vocabulario personalizado, mejora la precisión con los nombres propios
• En macOS, la transcripción se procesa completamente de forma local

Elegir el motor de IA

Puedes usar uno u otro según lo que necesites.

Dónde configurarlo

• macOS: Barra de menús → "Configuración de IA…"
• Windows: Bandeja del sistema → "⚙️ Configuración de IA"

La Configuración de IA se divide en las pestañas "Generación de texto", "Transcripción", "Imágenes", "Voz", "Conectar" y "Conexión P2P". En este capítulo se explica "Generación de texto". La generación de imágenes y de voz se explica en "6. Utilidades"; "Conectar", en "8. Nivel avanzado: conectar Claude", y "Conexión P2P", en "9. Cuenta y sincronización".

Los elementos configurables son: endpoint / clave de API / nombre del modelo / número máximo de tokens / temperature / activado o desactivado.

Cómo conectarte a LM Studio: en "llama.cpp / LM Studio", elige el servidor externo e introduce como destino la dirección de LM Studio (por defecto, http://127.0.0.1:1234). Con "Obtener lista" puedes elegir entre los modelos del servidor; un modelo que aún no esté cargado se carga con la primera solicitud. Si activaste la autenticación en LM Studio, introduce también la clave de API (la clave se guarda solo en este equipo).

Cómo conectar con Claude, ChatGPT y Gemini

La integración con Claude Desktop / Claude Code es una conexión MCP, que se explica más abajo en "8. Nivel avanzado: conectar Claude". Desde Claude puedes consultar el estado de tu mascota, y el personaje te muestra con sus movimientos cómo avanza el trabajo de Claude.

Si quieres usar los modelos de ChatGPT, introduce en "Configuración de IA" el endpoint, la clave de API y el nombre del modelo de la API de OpenAI. No se conecta directamente a la web de ChatGPT ni a tu cuenta de ChatGPT. Revisa las condiciones de uso y los precios de la API por separado de tu suscripción a ChatGPT.

En cuanto a los modelos de Gemini, Google ofrece un endpoint de la API de Gemini compatible con OpenAI. Para usarlo, introduce en "Configuración de IA" el endpoint correspondiente, tu clave de la API de Gemini y el nombre del modelo. No se vincula directamente con tu cuenta de la aplicación Gemini. Las funciones disponibles dependen del modelo elegido y de las especificaciones de la API compatible.

La transcripción de voz es una función independiente de estos ajustes de IA en la nube. En la versión de macOS se procesa en tu equipo y, además de la entrada de voz con el Shift derecho, también puedes soltar archivos de audio sobre el personaje para transcribirlos.

Si usas llama.cpp de forma local, especifica una longitud de contexto de 8192 o más. Si no es suficiente, algunas funciones (como la Consulta) no estarán disponibles.

Si la IA no responde, se cambia automáticamente a frases preparadas de antemano. Nunca se queda en silencio.

---

6. Utilidades

La mayoría de las herramientas las va aprendiendo poco a poco, a medida que crece. Qué compañero aprende qué es una sorpresa que descubrirás al criarlo. Una herramienta aprendida se puede seguir usando aunque ese compañero ya no esté. Si has iniciado sesión, también puedes usarla en tus otros dispositivos con la misma cuenta.

Lo que puedes usar desde el principio

• Notas — Shift + Cmd + M abre una nota rápida. Cada nota es un archivo Markdown (→ "Notas", más abajo)
• Lanzador circular — la puerta de entrada a las herramientas aprendidas y a los cuidados, que se abre al mantener presionada la tecla fn (→ "Lanzador circular", más abajo)
• Tarjetas de crecimiento — convierte momentos especiales, como la eclosión o una evolución, en una tarjeta de imagen para compartir (→ "Tarjetas de crecimiento", más abajo)
• ZIP cifrado — al soltar un archivo sobre el personaje, puedes convertirlo en un ZIP con contraseña desde la confirmación que aparece. La contraseña te la dice tu compañero
• Enciclopedia — el registro de las formas que has encontrado (→ "4. El crecimiento y lo que viene después")
• Abrir como carpetas Git — abre desde el lanzador circular, en una sola lista, los proyectos Git que hay dentro de la carpeta que elijas (→ "Lista de proyectos Git", más abajo)

Lo que aprende al crecer

• Transcripción de voz — se puede usar en cuanto eclosiona (→ "5. Voz e IA")
• Historial del portapapeles — revisa lo que copiaste. Además de transcribir texto de imágenes (OCR), resumir y crear códigos QR, puede encontrar y eliminar caracteres invisibles mezclados en el texto copiado (como los de ancho cero o los de control bidireccional)
• Marcadores — la IA los etiqueta y resume automáticamente. Admite importar desde Chrome / Edge y revisar enlaces rotos
• Lector de RSS — interfaz de dos paneles, controles de teclado estilo Vim, importación y exportación de OPML. Te comenta lo que le pareció de los artículos que leyó
• Visor de texto — reconoce Markdown, Mermaid y PlantUML y los muestra con claridad. Los bloques de código tienen un botón para copiarlos, y los de Python se pueden ejecutar con ▶ para ver el resultado en otra ventana. También puedes abrirlo desde "Abrir con" en otras aplicaciones
• Gráfico de Git — suelta sobre el personaje una carpeta que contenga .git y verás su historial de commits como un gráfico. Para mostrarlo no usa el comando git: lee .git directamente. También puedes cambiar de rama (checkout) y hacer fetch, pull y push (→ "Lista de proyectos Git", más abajo)
• Paint sencillo — elige "Editar en Paint" en la confirmación que aparece al soltar una imagen. Permite copiar y pegar una selección rectangular, aplicar mosaico, rellenar, añadir texto, dibujar con lápiz, pincel y formas, y deshacer. Guarda en PNG / JPEG
• Preguntar qué es (macOS 27 o posterior) — desde la confirmación que aparece al soltar una imagen. El modelo integrado de Apple Intelligence te cuenta qué aparece en ella, con la forma de hablar de tu compañero. La imagen no sale de tu Mac
• Fragmentos dinámicos — escribe una palabra clave que hayas registrado y presiona Space / Tab / Enter para expandirla en un texto predefinido
• Agenda de hoy — te avisa 10 minutos antes de cada evento y te lee la agenda del día con su forma de hablar
• Horóscopo — clasificación en 100 tipos según la fecha de nacimiento, la fortuna del mes y horóscopo de amistad
• Consulta — tu pequeño compañero te escucha
• Generación de imágenes con IA — pídele un dibujo y lo hace (→ "Crear imágenes con IA", más abajo)
• Juegos — algunos compañeros aprenden juegos para hacer una pausa entre tareas. A qué podrás jugar es una sorpresa hasta que lo conozcas

Hay otras funciones que va aprendiendo a medida que usas la aplicación.

Lo que se activa al configurarlo

• Generación de voz con IA — al guardar un método en "Voz" de la Configuración de IA, aparece "Crear voz con IA…" en el menú y en el lanzador circular (→ "Crear voz con IA", más abajo)
• Radio IA — cuando tu personaje ya conoce el Lector RSS y tienes lista una IA de generación de texto y la generación de voz, tus artículos sin leer se convierten en un programa de radio con dos presentadores (→ "Radio IA", más abajo)

Lanzador circular

Si mantienes presionada la tecla fn (🌐) durante 0,3 segundos o más, aparece un anillo alrededor del personaje. No le quita el foco a la aplicación en la que estás trabajando.

• Si dejas el foco sobre un grupo durante 1,5 segundos, entra en él aunque no lo confirmes
• Puedes cambiar qué elementos aparecen y en qué orden en "Lanzador circular…", dentro de Configuración en la barra de menús. Se puede elegir entre las herramientas aprendidas, los cuidados, las pantallas de configuración y tus aplicaciones favoritas, y agruparlos hasta en 3 niveles. Para quitar un elemento, arrástralo fuera del anillo en la pantalla de configuración
• Si la presionas junto con otra tecla, funciona como un atajo normal (fn + F1, etc.)
• Lo que hace el sistema al presionar fn brevemente (escribir emojis o cambiar la fuente de entrada) sigue funcionando igual

Notas

Con Shift + Cmd + M se abre una nota rápida en cualquier momento. Desde "Notas" en la barra de menús se abre la ventana con la lista de notas, que incluye editor, vista previa y esquema.

• Cada nota es un archivo Markdown. No es un formato propio de la aplicación, así que cualquier otro editor las abre
• Puedes cambiar la carpeta donde se guardan desde los ajustes, incluso apuntar a un almacén de Obsidian tal cual
• Puedes organizarlas en grupos (carpetas)
• Admite la misma selección múltiple que Sublime Text (Cmd + D selecciona la siguiente aparición de la misma palabra, Shift + Cmd + L divide la selección en líneas, y también hay selección rectangular)
• Cmd + N crea una nota nueva y Cmd + E alterna entre vista previa y edición
• Puedes guardar algo como nota desde otras herramientas, como el historial del portapapeles
• Las notas que borras van a la papelera del sistema operativo, así que se pueden recuperar

También puedes pedirle a Claude que lea y escriba tus notas (→ "8. Nivel avanzado: conectar Claude"). Y con la Conexión P2P puedes sincronizarlas con tu otro Mac (→ "9. Cuenta y sincronización").

Al soltar archivos sobre el personaje

Una vez que ha eclosionado, puedes soltar muchas cosas sobre el personaje.

La vista previa, "Editar en Paint", "Preguntar qué es" y el gráfico de Git están disponibles una vez que aprende el visor de texto ("Preguntar qué es" requiere macOS 27 o posterior). Hasta entonces, solo puedes elegir entre dárselo de comer y el ZIP cifrado.

Lista de proyectos Git (Abrir como carpetas Git)

Reúne en una sola lista los proyectos Git repartidos por muchas carpetas y ábrelos desde ahí. Se puede usar desde el principio (abrir el gráfico de Git desde la lista requiere que haya aprendido el visor de texto).

Cómo usarla

1. En "Lanzador circular…", dentro de Configuración en la barra de menús, añade "Abrir como carpetas Git…" al anillo y elige la carpeta de partida
2. Al elegir ese elemento en el anillo, se abre la lista

• Busca hasta 4 niveles por debajo de la carpeta de partida, de menos a más profundo, y muestra como proyecto Git cada carpeta que contiene .git, deshaciendo el anidamiento en una sola lista. No entra en carpetas como node_modules, build, dist o vendor. Muestra hasta 300 proyectos
• El orden es por la última vez que los tocaste. Escribe para filtrar por nombre
• Cada fila muestra el icono, el nombre, la carpeta superior, cuándo lo tocaste por última vez, el número de cambios sin confirmar, cuántos commits va por delante / por detrás de su upstream, la rama, el servicio de origen (GitHub, etc.) y la cuenta, el número de pull requests abiertos y un botón para copiar la ruta completa
• El estado se lee directamente de .git, así que no se usa el comando git. Solo se usa la red para contar los pull requests

Teclas (macOS)

• Los comandos predeterminados son git status, git pull --ff-only y claude. Puedes registrar hasta 20 y asignar a cada uno una tecla que funciona dentro de la lista

Operaciones de Git desde las insignias (macOS)

• Si dejas el puntero 1 segundo sobre la insignia de cambios, de commits por delante, por detrás o de la rama, o haces clic en ella, puedes hacer ahí mismo commit ("Confirmar"), commit y push ("Confirmar y enviar"), push ("Enviar"), pull ("Traer") y fetch ("Obtener")
• Una IA local redacta un borrador del mensaje de commit a partir de las diferencias. Si tu IA de generación de texto está en la nube, cambia al modelo integrado de Apple o al llama.cpp integrado, y si no hay ninguno, no redacta nada. Las diferencias nunca se envían a la nube
• Los archivos sin seguimiento no se incluyen en el commit de forma predeterminada
• El push solo avanza la rama (fast-forward); nunca fuerza el push. El pull usa --ff-only

Pull requests (macOS)

• Muestra la lista de pull requests abiertos en GitHub y Bitbucket, y sus detalles (autor, ramas, si se pueden fusionar, comprobaciones y estado de la revisión)
• La pestaña "Conversación" muestra la descripción, los comentarios y las revisiones como un chat, de los más antiguos a los más recientes; la pestaña "Archivos modificados" muestra los cambios
• Puedes enviar comentarios, usar respuestas guardadas (vienen 5, como LGTM o un agradecimiento, y se pueden editar), y aprobar, fusionar o rechazar. Todo ello pide confirmación y muestra la cuenta con la que se actúa
• GitHub usa la sesión iniciada del comando gh (gh auth). El token que recibe se olvida al cerrar la ventana
• Bitbucket usa tu dirección de correo de Atlassian y un token de API, que se guardan en el mismo lugar que las claves de API de la Configuración de IA

Atajos (macOS)

Con "Asignar un atajo…" en el menú contextual de la lista, puedes asignar al Finder, al gráfico de Git, a Terminal, a los pull requests o a los comandos de un proyecto concreto un atajo de teclado que funciona en toda la aplicación.

Gráfico de Git

• Unos carriles de colores muestran dónde se separan y se unen las ramas
• Haz doble clic en el nombre de una rama para cambiar a ella (checkout), y usa el menú contextual para hacer fetch, pull o push. Esto ejecuta tu git local (para mostrar el gráfico sigue leyendo .git directamente)
• Los hashes y los mensajes se pueden copiar con un botón que aparece al pasar el puntero
• Las fechas se muestran como "hace 3 horas"; al pasar el puntero se ve la fecha y hora exactas

Crear imágenes con IA

Cuando aprende la generación de imágenes con IA, aparece "Crear imagen con IA…" en el menú del personaje y en el lanzador circular. Escribe una petición y tu compañero hará el dibujo y lo mostrará en su globo de diálogo. Haz clic en la imagen terminada para abrirla en Paint sencillo. Se guarda en PNG en ~/Pictures/AI Coach/.

El método se elige en la pestaña "Imágenes" de la Configuración de IA.

• La petición admite hasta 2.000 caracteres. Para cada método, se recorta a la longitud que acepta antes de enviarla
• En "Idioma de la petición" puedes elegir para cada método si traducirla al inglés antes de enviarla (en Draw Things está activado por defecto). En macOS se traduce con la función de traducción de Apple, así que la petición no sale de tu equipo para traducirse. Lo que dice tu compañero y el globo con la imagen terminada muestran la petición original
• Con los métodos externos, la imagen puede tardar varios minutos (a veces, unos 10 minutos)
• Si falla, el globo de diálogo indica el motivo (clave incorrecta, límite de uso, filtro de seguridad, etc.)
• La prueba de conexión comprueba si se puede conectar sin crear ninguna imagen
• Los precios dependen de las condiciones del servicio elegido. AI Coach no cobra nada extra

Crear voz con IA

Elige un método en la pestaña "Voz" de la Configuración de IA y guárdalo listo para usar: aparecerá "Crear voz con IA…" en el menú del personaje y en el lanzador circular. Escribe un texto y lo convierte en audio, que se guarda en ~/Music/AI Coach/. Si activas "Reproducir en cuanto esté lista", podrás escucharlo al momento.

• Para usar Irodori-TTS + speech.cpp, prepara el comando speech (con el instalador de speech.cpp o compilándolo desde el código fuente). Su ubicación se indica en "Voz" de la Configuración de IA
• El modelo se descarga la primera vez que lo usas (entre 1 y 2 GB). También puedes descargarlo antes desde la Configuración de IA, y con la prueba de conexión puedes comprobar la licencia y la procedencia del modelo. Irodori-TTS usa unos 2 GB de memoria por modelo
• speech.cpp y los modelos no vienen incluidos en AI Coach y se usan según las condiciones de sus respectivos autores. No los uses para clonar la voz de nadie sin su consentimiento ni para suplantar a otra persona

Radio IA

La radio IA convierte tus artículos RSS sin leer en un programa de radio, de tres en tres, presentado por los dos personajes de tu pantalla. Quien conduce presenta cada noticia y su compañero responde con impresiones y preguntas sencillas. El guion lo escribe la IA de generación de texto y las voces salen del método de generación de voz.

Cómo escucharla

Empieza desde el menú del personaje → "Lector RSS" → "Escuchar la radio IA", o desde "Radio" en el lanzador circular. Mientras suena, la opción del menú pasa a ser "Detener la radio IA".

• Si solo hay un personaje en pantalla, uno que hayas conocido en la Enciclopedia viene como invitado y vuelve a casa al terminar el programa
• Al empezar, un bocadillo te dice cuántos artículos se eligieron y con qué IA se está preparando (la IA de texto y su modelo, y el método de voz)
• Mientras queden artículos sin leer, sigue de tres en tres hasta que la detengas. Los artículos ya emitidos se marcan como leídos
• Cuando cambia el tema, si el artículo tiene imagen, aparece en el bocadillo de quien conduce. Haz clic en un bocadillo para abrir ese artículo en el lector
• Las dos voces se eligen según la personalidad, la forma de hablar y la edad de cada personaje
• Se pausa durante la transcripción y la Consulta, y luego sigue donde se quedó
• Durante la emisión, si pasas el ratón sobre el personaje que conduce, aparecen un botón de pausa y un control de volumen
• Si el guion lo escribe una IA en la nube, o las voces son de ElevenLabs, antes de empezar se muestra una estimación de tokens y caracteres para que lo confirmes

En el menú del Lector RSS puedes activar estas tres opciones (todas desactivadas por defecto).

Escuchar la radio IA totalmente en local (recomendado)

Si la IA del guion y las voces funcionan en tus propios Mac, el programa se hace sin enviar artículos ni guiones a la nube. Esta es la configuración que recomendamos.

Un modelo de 27B es grande, así que recomendamos ejecutar LM Studio en un Mac con memoria de sobra y tomarlo prestado por Conexión P2P desde el Mac que usas a diario. También puedes ejecutar ambas cosas en un solo Mac.

1. Prepara las voces (el Mac en el que escuchas)

1. Barra de menús → "Configuración de IA…" → "Voz", y elige "Irodori-TTS + speech.cpp (local)" como método
2. Si no se encuentra el comando speech, pulsa "Instalar speech.cpp". Justo después se descarga el modelo (el predeterminado, irodori-tts-mf, de unos 1,9 GB)
3. Guarda. Tu personaje te avisa en un bocadillo cuando está listo

Cuando lee Irodori-TTS, el guion incluye emojis que cambian la forma de leer (asentir, sorpresa, una risita, etc.), así que los asentimientos y las risas del compañero se notan en la voz. Los emojis no aparecen en los bocadillos.

2. Prepara la IA del guion (el Mac que ejecuta el modelo)

1. Instala LM Studio, descarga un modelo (por ejemplo, qwen/qwen3.8-27b) y cárgalo
2. Inicia el servidor local desde la pantalla para desarrolladores de LM Studio (por defecto, http://127.0.0.1:1234)

3. Toma prestada la IA por Conexión P2P

1. Inicia sesión con la misma cuenta en los dos Mac y actívala en "Configuración de IA" → "Conexión P2P…" de la barra de menús de cada uno (→ "Conectar tus propios Mac entre sí (Conexión P2P)" en "9. Cuenta y sincronización")
2. En el Mac que ejecuta el modelo, en "Compartir la IA de este Mac", elige la IA compatible con OpenAI (LM Studio, Ollama, etc.). Si dejas el puerto en blanco, se encuentra automáticamente el servidor en marcha
3. En el Mac en el que escuchas, deja activado "Usar automáticamente la IA prestada" (viene activado). Si hay una IA de texto prestada, la radio IA la usa antes que la de tu Configuración de IA

Para hacerlo todo en un solo Mac, prescinde de la Conexión P2P: en Configuración de IA → "Generación de texto", elige "llama.cpp / LM Studio" → servidor externo, introduce http://127.0.0.1:1234 como destino y elige el modelo con "Obtener lista".

4. Escucha

1. En el menú del Lector RSS, activa "Leer el artículo completo en la radio IA" (hasta los artículos que solo tienen título dan más de qué hablar)
2. Elige "Escuchar la radio IA". Si el primer bocadillo dice "Guion: IA prestada por Conexión P2P (qwen/qwen3.8-27b)" y "Voz: Irodori-TTS + speech.cpp (local)", todo funciona en local

Con esta configuración, lo único que sale de tus Mac es la consulta de tus fuentes RSS y de las páginas de los artículos (visitas a esos sitios), la descarga del modelo la primera vez que lo usas (Hugging Face) y la comunicación que la Conexión P2P usa para encontrar tu otro Mac. El guion y las voces se crean en tus propios Mac, y no aparece ninguna ventana de confirmación.

Tarjetas de crecimiento

Los momentos especiales, como la eclosión, una evolución o aprender una herramienta nueva, se pueden convertir en una tarjeta de imagen de 1200×675. En esos momentos te pregunta si quieres crear una tarjeta, y puedes crearla cuando quieras con "Crear tarjeta de crecimiento…" en el menú del clic derecho del personaje.

• Puedes copiar la imagen, copiar el texto para publicar, exportarla como PNG y compartirla
• Puede abrir la pantalla de publicación de X, Bluesky o Discord. Publicar o no lo decides tú: AI Coach nunca publica nada automáticamente
• La tarjeta se crea solo dentro de tu equipo. Tampoco guarda ninguna credencial de redes sociales

Sobre la Consulta

Puedes iniciarla desde el menú del clic derecho. No juzga ni te impone consejos: solo escucha y, al final, te ofrece un pequeño siguiente paso.

El contenido de la conversación no se guarda. Se borra de la memoria en el momento en que cierras la ventana.
Cuando aparecen sentimientos muy difíciles, se muestran en pantalla líneas de ayuda especializadas.

Cada personaje maneja su conversación por separado.

---

7. Atajos de teclado

macOS

Las teclas de la entrada de voz, el historial del portapapeles, los marcadores, el lector de RSS, los fragmentos y la agenda de hoy se pueden usar una vez que tu compañero aprende la herramienta correspondiente. La nota rápida y el lanzador circular están disponibles desde el principio.

Windows

La Consulta no tiene un atajo asignado. Ábrela desde el menú del clic derecho.

---

8. Nivel avanzado: conectar Claude

Esta función llega primero a macOS. La compatibilidad con Windows llegará en una actualización futura.

Qué permite hacer

Ahora se le puede hablar a AI Coach desde Claude.

Pregunta "¿cómo está mi pequeño?" y Claude te cuenta su estado y su ánimo.
Pídele "dale de comer" y, después de que confirmes, el personaje de tu escritorio come de verdad.
Y mientras Claude trabaja en algo largo, el pequeño de tu escritorio salta y se detiene para mostrarte cómo va.

Aunque no estés mirando la pantalla, el movimiento de esa pequeña vida sobre tu escritorio te dice "sigue trabajando" o "ya terminó". Eso es lo que más queríamos construir aquí.

Además, puedes pedirle a Claude que cree imágenes o voz, que lea y escriba tus notas, o que abra el gráfico de Git de un repositorio.

No se trata de añadir "una IA más". Se trata de que una conversación con Claude llegue hasta la pequeña vida de tu escritorio.

Qué hace falta para conectarlo

Todo ocurre dentro de este equipo. Nada pasa por internet.

Cómo conectarlo

1. En la barra de menús de AI Coach, abre "Configuración de IA…" → la pestaña "Conectar"
2. En "Conectar con Claude", presiona "Añadir" junto a la aplicación que uses (si la integración está desactivada, se activa automáticamente)
3. La primera vez que se conecte, AI Coach te preguntará si permites la conexión

En Claude Desktop se abre una pantalla de confirmación: presiona "Instalar" y listo. No necesitas Node.js.

En Claude Code, se registra para que puedas usarlo desde cualquier proyecto. Necesitas Node.js 22 o posterior en tu PATH. Si ya tienes Claude Code abierto, vuelve a conectarlo con /mcp o empieza una conversación nueva.

Para Cursor y otras aplicaciones, copia y pega la configuración de "Conectar manualmente". En la misma pantalla verás si ya está añadido y si hay una versión nueva.

Qué le puedes pedir

Con varios personajes, se listan sus nombres y estados uno al lado del otro. Nada se ejecuta mientras "a cuál y qué" siga siendo ambiguo.

Tu personaje te muestra cómo va el trabajo

Es la parte más característica de la integración. Mientras Claude trabaja, ese trabajo se refleja en cómo se mueve tu mascota.

El salto deja la sombra en el suelo y solo salta el personaje: el mismo movimiento del icono que rebota en el Dock de macOS, así que siempre se distingue de su paseo habitual.

• Durante un trabajo largo no hay una lluvia de globos de diálogo. Solo un salto de vez en cuando y un pequeño emoji
• Mientras piensa hace lo contrario: deja de pasear y se queda quieto
• Estos avisos nunca cuestan HP. No tocan ni un parámetro de crianza y tampoco suena nada
• Se borran solos como máximo a los 15 minutos. Si Claude se detiene sin decir nada, no te quedas con un "trabajando" permanente
• No se muestra nada en un personaje dormido, un huevo, un fantasma ni uno guardado. Lo mismo durante la consulta, una conversación o una transcripción
• Incluso mientras trabaja, sigue reaccionando cuando lo tomas y sigue avisando de lo que necesita. No se convierte en un adorno

Pedir cuidados

Claude solo puede pedir cinco cosas: darle de comer, dormir, despertar, pasear y cuidar.

Siempre se te pide confirmación. No existe ningún camino en el que un parámetro de crianza cambie solo por decisión de Claude.

Desde los botones del panel puedes saltarte la confirmación con "no volver a mostrar", pero los cuidados que pide Claude se confirman todas las veces, sin importar ese ajuste.

Comprar, incubar, poner nombre, cambiar de personaje, el romance y la puesta de huevos, y la despedida quedan fuera de la integración. Eso lo decides tú.

Que te muestre un archivo

Un archivo local con el que Claude esté trabajando se puede abrir en el visor de AI Coach.

• Solo AI Coach lee el archivo. Su contenido, los datos de imagen y la ruta completa nunca vuelven a Claude
• Mermaid se dibuja con el motor incluido en la aplicación. No se descarga nada de fuera
• No se abren los SVG que contienen scripts o referencias externas
• No basta con la extensión: el contenido se comprueba antes de mostrar nada

Pide "muéstrame este archivo en AI Coach" y podrás revisarlo en tu propia pantalla sin que Claude lea el contenido.

Que lea y escriba tus notas

Puedes pedirle a Claude que te apunte algo, o que rescate una nota que escribiste antes. Sin complementos
ni un segundo servidor: AI Coach lo resuelve por sí solo.

La lectura y escritura de notas está disponible una vez que tu compañero aprende esa herramienta. Si desactivas "Permitir leer y escribir notas" en "Conectar" de la Configuración de IA, puedes rechazar solo las notas sin tocar el resto de la integración.

• Puedes apuntar esto a la carpeta que prefieras desde los ajustes, incluido un almacén de Obsidian tal cual
• Son archivos Markdown normales, no un formato propio. Cualquier editor los abre
• Claude no anda hurgando en ellas. El listado devuelve solo títulos y primeras líneas; el cuerpo llega a Claude únicamente cuando le pides que lea o busque
• Se escriben hasta 32 KiB de una vez y se leen hasta 32 KiB de una vez (una nota larga llega por partes). Una nota admite hasta 1 MiB
• Un listado devuelve como máximo 200 notas; una búsqueda, como máximo 50 resultados
• Antes de reescribir una, comprueba que nada haya cambiado desde que la leyó. Si algo la editó mientras tanto, vuelve a leerla en lugar de sobrescribirla
• Al borrar, el archivo va a la papelera del sistema operativo, así que un error se puede deshacer

Una instrucción que conviene darle a Claude

Pega lo siguiente en las Instructions de Claude y te informará de su trabajo sin que tengas que pedírselo cada vez. Cópialo tal cual.

Estás conectado a AI Coach. Usa las herramientas MCP de AI Coach disponibles según estas reglas.

[Principios]
- Las notificaciones son un apoyo. Incluye siempre los resultados importantes, las preguntas y los errores en el cuerpo de la respuesta.
- Salvo saludos y preguntas de una frase, informa del avance en trabajos de varios pasos: investigación, edición, generación, compilaciones y pruebas.
- No incluyas secretos, credenciales, datos personales, contenido de archivos ni registros largos en las notificaciones.

[Estado del trabajo]
- Usa `thinking` con `report_ai_coach_activity` al plantear el enfoque, y `working` durante el trabajo real.
- Envía `waiting` justo antes de pedir una respuesta o aprobación, `succeeded` una vez cuando el trabajo verificado esté completo, y `failed` una sola vez cuando ya no sea posible completarlo.
- Que `label` describa el estado en 60 caracteres o menos. No repitas el mismo estado y el mismo texto.

[Estado y cuidados]
- Si preguntan cómo están las mascotas, usa `open_ai_coach_dashboard` o `refresh_ai_coach_status`.
- Muestra la acción de cuidado propuesta con `prepare_ai_coach_care`, y usa `commit_ai_coach_care` solo tras la confirmación explícita del usuario. Nunca ejecutes un cuidado por tu cuenta.

[Mensajes y archivos]
- Usa `show_ai_coach_message` solo para un ánimo breve o para lo que el usuario quiera que diga la mascota.
- Usa `show_ai_coach_file` solo con un archivo local que el usuario haya pedido mostrar. No copies su contenido ni la ruta completa en la respuesta o las notificaciones.

[Notas]
- Lee o escribe notas solo cuando la persona pida buscar, leer o apuntar algo. No te pongas a curiosear entre ellas.
- Antes de reescribir una nota existente, léela primero y pasa `expectedModifiedAt`. Si hay conflicto, vuelve a leerla en lugar de sobrescribir.
- Si el cuerpo supera los 32 KiB, crea la nota y luego añade al final. Borra solo cuando te lo pidan.
- No copies el contenido de una nota más allá de lo que se te pidió.

[Imágenes, voz y gráfico de Git]
- Usa `generate_ai_coach_image` / `generate_ai_coach_audio` solo cuando el usuario pida generar una imagen o un audio. Pueden tardar varios minutos en terminar.
- Para elegir una voz, obtén primero la lista con `list_ai_coach_voices` y pasa el `voiceId` de la voz que vayas a usar.
- Usa `show_ai_coach_git_graph` solo con los repositorios que el usuario haya dicho que quiere ver.

[Si no está disponible]
- Si AI Coach no está en ejecución o no está conectado, continúa con la tarea principal cuando sea posible. No reintentes una y otra vez el mismo fallo de conexión.
- Escribe la respuesta final de modo que el resultado y el siguiente paso se entiendan aunque el usuario no haya visto a la mascota.

Existe por una sola razón: lo que empieza también debe anunciarse como terminado. Nada de saltar al principio de un trabajo y guardar silencio al final.

Seguridad y privacidad

• A Claude solo le llega lo mínimo imprescindible: estado, ánimo y poco más
• Nunca se entregan datos personales, credenciales, claves de API ni la partida completa
• El portapapeles, el calendario, el RSS y el contenido de las transcripciones nunca se envían automáticamente
• Las ilustraciones y los recursos de los personajes no salen de la aplicación
• El identificador que designa al personaje es un seudónimo. No se puede cruzar con otro equipo ni con otra instalación. También puedes hacer que cambie en cada inicio
• Todo lo que modifica el estado pasa siempre por tu confirmación
• Cuando pides generar una imagen o un audio, la petición o el texto se envían al destino elegido en la Configuración de IA (salvo con "En el dispositivo" e Irodori-TTS + speech.cpp; → "11. Privacidad y datos")
• Puedes desactivar la integración en cualquier momento desde los ajustes

Dicho esto, lo que le muestres a Claude queda sujeto al procesamiento de Claude. Eso sigue siendo cierto incluso en una integración que se ejecuta por completo en tu equipo. Úsala partiendo de la base de que lo que no quieras compartir, no se comparte.

---

9. Cuenta y sincronización

Iniciar sesión

Puedes empezar a usar la aplicación de inmediato, sin crear una cuenta. Más adelante puedes vincular una cuenta de Google o de Apple.

Necesitas iniciar sesión en los siguientes casos.

• Al comprar huevos
• Al transferir tus datos a otro dispositivo
• Al usar la Conexión P2P
• Al empezar el modo de prueba

Qué se sincroniza

Si has iniciado sesión, los siguientes datos se guardan en la nube.

• El estado del personaje (condición física, crecimiento, linaje, relaciones, recuerdos)
• El perfil del dueño (apodo, fecha de nacimiento, hora de nacimiento)
• El registro de compras de huevos
• Los feeds de RSS registrados, los fragmentos dinámicos y los prompts personalizados
• Las herramientas aprendidas y la Enciclopedia (una herramienta aprendida en un dispositivo también se puede usar en los demás)

Lo que no se sincroniza: el historial de transcripciones de voz, la posición de las ventanas y la caché.

La sincronización en la nube se activa en las cuentas que han comprado al menos un huevo. Si solo usas el huevo que viene con la aplicación, tus datos se quedan en ese dispositivo.

Cuándo se sincroniza

La aplicación sincroniza automáticamente. No hace falta configurar ni hacer nada.

• Guardado: al ejecutar "Ir a casa" / al convertirse en fantasma / al salir de la aplicación / al entrar en suspensión
• Carga: al abrir la aplicación / al reanudar desde la suspensión / al iniciar sesión / cuando se refleja una compra

La crianza también avanza sin conexión. Aunque no tengas internet, siempre pueden estar juntos.

Continuar en otro dispositivo

Si inicias sesión con la misma cuenta en un dispositivo nuevo, puedes transferir tus datos. Si en ese dispositivo aún no has criado nada, los datos de la nube entran tal cual.

Si has criado en varios dispositivos, los datos se combinan automáticamente. El registro de compras y el registro de crianza nunca retroceden. Sin embargo, la condición física (HP, saciedad, fatiga) da prioridad al registro más reciente, así que puede variar hacia arriba o hacia abajo.

Solo cuando la última actualización tiene una diferencia de 7 días o más aparecerá un cuadro de diálogo para confirmar cuál usar. Sea cual sea la que elijas, el registro de compras siempre se conserva.

Conectar tus propios Mac entre sí (Conexión P2P)

Conecta directamente por P2P tus propios Mac en los que hayas iniciado sesión con la misma cuenta. Es un mecanismo distinto de la sincronización en la nube y te permite:

• Sincronizar las fuentes RSS, las notas y las asignaciones de atajos
• Usar desde un Mac la IA que se ejecuta en el otro (Draw Things, llama.cpp, LM Studio, etc.)
• Tomar prestado el SSH de un Mac para iniciar sesión en él desde el otro Mac, o desde un iPhone o un iPad

Es una función experimental. Su funcionamiento y sus pantallas pueden cambiar en futuras actualizaciones.

Cómo empezar

1. En cada Mac, inicia sesión con la misma cuenta de Apple o de Google
2. Abre "Configuración de IA" → "Conexión P2P…" en la barra de menús y activa "Vincular con mis personajes en mis otros dispositivos"
3. Cuando lo actives también en el otro Mac, aparecerá en la lista "Dispositivos" y, al conectarse, se mostrará "Conectado"

Cuando otro dispositivo con la misma cuenta aparece en la lista, un rato después del inicio el personaje te pregunta una sola vez, a su lado, si quieres "Vincular" o "Ahora no". Si eliges "Vincular", se activa. No hace falta introducir ninguna clave ni ningún código.

Sincronización

En "Sincronización", dentro de la pantalla de ajustes, elige qué sincronizar entre "Fuentes RSS", "Notas" y "Asignaciones de atajos" (por defecto no se sincroniza nada). Cada tipo se sincroniza solo con los dispositivos que hayan activado ese mismo tipo.

• Lo que añadas o modifiques en cualquiera de los dos se conserva en ambos. La primera vez que sincronizas, se combina el contenido de los dos
• Lo que borres en uno también se borra en el otro (las notas van a la papelera)
• Si la misma nota se modificó en los dos, la más reciente conserva el nombre original y a la otra se le añade al nombre "(copia en conflicto de …)", con el nombre del dispositivo
• Un cambio que borraría mucho de golpe (la lista del otro dispositivo está vacía, o desaparecen 10 elementos o más y más de la mitad) se considera un accidente y no se borra nada. Si cambiaste la carpeta donde se guardan las notas, tampoco se borra nada: se combina todo
• En el RSS solo se sincronizan las suscripciones a los feeds y si cada uno se revisa o no. Los artículos, el estado de leído y las estrellas no se sincronizan
• En la fila de cada dispositivo aparece "Sincronizado <hora>". Con "Sincronizar ahora" puedes volver a enviar los datos

Usar la IA de otro Mac

En el Mac que la comparte, en "Compartir la IA de este Mac" de la pantalla de ajustes, elige qué quieres compartir entre Draw Things, llama.cpp (llama-server) y las IA compatibles con OpenAI, como LM Studio u Ollama (por defecto, no se comparte nada).

• Si dejas el campo del puerto en blanco, se encuentra y se comparte automáticamente lo que esté funcionando en este Mac. Debajo de la fila aparece algo como "Funcionando en el puerto 7860"
• En el Mac que la usa, "Usar automáticamente la IA prestada" (activado por defecto) introduce en la Configuración de IA la IA que recibe. Cuando la conexión lleva 90 segundos cortada, o al desactivar la Conexión P2P, vuelve la configuración anterior
• Para hacerlo a mano, presiona "Usar" junto a la URL local (http://127.0.0.1:<número>) que aparece debajo de la fila del dispositivo. Se introduce en la Configuración de IA y se cambia a ese método o proveedor
• Solo se puede llegar a ese puerto en 127.0.0.1 del Mac que la comparte

Compartir y tomar prestado el SSH

En el Mac que lo comparte, activa "Compartir el SSH de este Mac" en la pantalla de ajustes (desactivado por defecto; si el campo del puerto está en blanco, se usa el 22).

• Hace falta tener activada la "Sesión remota" del Mac (Ajustes del Sistema → General → Compartir). Debajo de la fila aparece si SSH está funcionando y el nombre de usuario
• Recomendamos configurar la Sesión remota para que solo acepte inicios de sesión con clave, no con contraseña
• En el Mac que lo usa, debajo de la fila del dispositivo aparece ssh -p <puerto local> <usuario>@127.0.0.1 con un botón "Copiar". Pégalo en Terminal para iniciar sesión en el Mac que lo comparte
• El SSH prestado no se añade a la Configuración de IA
• También se puede usar desde un iPhone o un iPad (→ "Usar la terminal del Mac desde el iPhone y el iPad (Terminal AI Coach)", más abajo)

Mantener este Mac activo

Si activas "Mantener este Mac activo" en la pantalla de ajustes (desactivado por defecto), mientras la Conexión P2P esté activada y el Mac comparta IA o SSH, no entrará en reposo aunque no lo uses. Es porque, si entra en reposo, no se puede conectar a él desde el otro lado.

• La pantalla se apaga como siempre
• Si cierras la tapa, entra en reposo igualmente

La página "Conexión P2P" de la Configuración de IA

En "Conexión P2P", en la lista de la izquierda de la Configuración de IA, puedes ver el estado actual (desactivada, esperando, con cuántos dispositivos está conectada, qué IA está tomando prestada), además de una explicación de cómo funciona, para qué sirve y cómo empezar. "Abrir los ajustes de Conexión P2P…" abre la pantalla de ajustes. También aparecen sugerencias debajo del campo del servidor externo de llama.cpp y del campo de URL de Draw Things en la Configuración de IA.

Detener o quitar

• Puedes detenerla en cualquier momento desactivando el interruptor de "Conexión P2P…"
• Un dispositivo que ya no uses se puede quitar con "Quitar…" en la lista de la pantalla de ajustes. El dispositivo quitado desactiva la Conexión P2P por sí mismo; para volver a usarlo, vuelve a activarla en ese dispositivo

Cómo se mantiene segura

• Se crea automáticamente una clave para cada dispositivo. Nunca se te muestra ninguna clave ni código, ni se te pide que los introduzcas
• Solo se deja pasar, en el momento del saludo inicial al conectar, a los dispositivos que están en la lista de dispositivos de tu cuenta
• La comunicación va cifrada y, una vez conectados, el tráfico circula directamente entre los dos dispositivos, sin pasar por ningún servidor
• Para encontrar el otro dispositivo se usa una red distribuida pública (HyperDHT). La información que sale de tu equipo se resume en "11. Privacidad y datos"

Usar la terminal del Mac desde el iPhone y el iPad (Terminal AI Coach)

Se está preparando su publicación en el App Store.

La aplicación para iPhone y iPad "Terminal AI Coach" se conecta directamente por P2P al SSH que tu Mac comparte mediante la Conexión P2P, para que manejes la terminal del Mac desde el iPhone o el iPad. No hace falta abrir puertos, ni una VPN, ni una IP fija.

Para usarla

1. En el Mac, activa la "Sesión remota" (Ajustes del Sistema → General → Compartir)
2. En AI Coach del Mac, activa la Conexión P2P y "Compartir el SSH de este Mac" (→ "Conectar tus propios Mac entre sí (Conexión P2P)", más arriba)
3. En Terminal AI Coach del iPhone o el iPad, inicia sesión con el mismo Apple ID o la misma cuenta de Google que en el Mac. En la lista aparecen tus PC que tienen activada la Conexión P2P
4. Copia la clave pública de la aplicación y añádela a ~/.ssh/authorized_keys en el Mac
5. Toca "Open Terminal" para iniciar sesión en el Mac

Sobre la terminal

• Inicia sesión con una clave Ed25519 propia de ese dispositivo. La clave privada nunca sale del dispositivo
• La primera vez que te conectas a un equipo, comprueba la huella de su clave de host y, si alguna vez cambia, te avisa y se detiene
• Teclas auxiliares para Esc, Tab, Ctrl y las flechas, y compatibilidad con teclados externos
• Pellizca con dos dedos para cambiar el tamaño del texto
• Redúcela a una ventana pequeña (mini) para seguir viendo lo que pasa mientras miras la lista de PC
• También funcionan aplicaciones de pantalla completa como vim o top
• Puedes probarla sin iniciar sesión con "Try the Demo"
• Puedes eliminar tu cuenta desde la propia aplicación
• Requiere iOS 17 o posterior

---

10. Comprar huevos

Planes

Es un pago único. No es una suscripción. Una vez que compras, no hay cargos adicionales.

Cómo comprar

1. Menú de la aplicación → "Comprar huevos…" abre el navegador (o entra directamente desde aic0t.com)
2. Inicia sesión con Google o correo electrónico
3. Elige la cantidad y continúa a Stripe Checkout
4. Al completar el pago, los huevos llegan a la Bandeja de incubación

Se admiten tarjeta / Apple Pay / Google Pay / Link. El pago lo procesa Stripe y nosotros nunca guardamos los datos de tu tarjeta. El recibo se envía automáticamente por correo electrónico.

Cuándo se refleja

Después de completar el pago, si tienes la aplicación abierta, los huevos llegan de inmediato. Si no la tienes abierta, aparecerán en la Bandeja de incubación la próxima vez que la abras.

Sobre los huevos premium

Los que nacen de un huevo comprado tienen las capacidades básicas de la primera generación (como el HP máximo o el valor inicial de inmunidad) un poco más altas. En muy raras ocasiones, pueden nacer con un color limitado.

No es Pay to Win. No puedes indicar qué forma tomará. Eso lo decide la manera en que lo críes.

Reembolsos

Puedes solicitar un reembolso dentro de 7 días desde la compra, siempre que aún no hayas incubado (iniciado la crianza de) el huevo en cuestión. Si solo una parte del paquete de 5 está sin usar, consideraremos un reembolso parcial por esa parte. Contáctanos a través del formulario de consultas.

Esta política no limita los derechos que te correspondan según la legislación aplicable.

---

11. Privacidad y datos

Lo que funciona de forma local

• La transcripción de voz (en macOS, procesamiento completamente sin conexión)
• El procesamiento de IA cuando eliges el LLM de Apple en el dispositivo o llama.cpp
• La generación de imágenes cuando eliges "En el dispositivo" (macOS) y la generación de voz cuando eliges Irodori-TTS + speech.cpp (local)
• La creación de programas de la radio IA cuando eliges el LLM de Apple en el dispositivo o llama.cpp (incluido LM Studio) para el guion e Irodori-TTS + speech.cpp (local) para las voces
• La lectura y escritura de los datos guardados

Los datos guardados se almacenan localmente cifrados con AES-256-GCM. Las imágenes y los datos de los personajes también están dentro de un contenedor cifrado, y el descifrado ocurre únicamente en memoria.

Lo que se envía al exterior

• Si configuras una API compatible con OpenAI: el contenido que se le pasa a la IA se envía al endpoint que hayas indicado
• Si activas el Contexto de actividad: el nombre de la aplicación activa, el título de la ventana y el texto seleccionado se usan como pistas para la IA. Si lo desactivas, no se obtiene nada en absoluto
• Etiquetado y resumen de marcadores con IA: el contenido de la página se le pasa a la IA
• Lector de RSS: se conecta a la red para obtener los feeds
• Comprobación de nuevas versiones (actualización automática): para saber si hay una versión nueva, la aplicación obtiene la información de la última versión del servidor de distribución (dl.aic0t.com) un minuto después de abrirse y, después, cada 6 horas. Solo se identifica con la versión de la aplicación, el número de compilación y el sistema operativo; no envía la cuenta, ningún ID del dispositivo ni información de los personajes. Si hay una versión nueva, la descarga del mismo servidor (estas descargas no cuentan en las cifras de descargas del sitio). Está activada de forma predeterminada; si desactivas "Actualizar automáticamente" en el menú, solo se conecta cuando eliges "Buscar actualizaciones…"
• Datos de los juegos aprendidos: algunos juegos no vienen incluidos en el instalador; cuando un compañero aprende uno, la aplicación descarga sus datos (cifrados) del servidor de distribución (dl.aic0t.com). Al aprender el juego, la aplicación pregunta si puede descargarlo, y lo descarga cuando aceptas o cuando vas a jugar. Una vez instalado, comprueba si hay una versión nueva al iniciarse y cada 6 horas, y la vuelve a descargar si la hay (en esta comprobación solo se identifica con la versión de la aplicación, el número de compilación y el sistema operativo). Antes de cada descarga, envía a nuestro servidor (Firebase) el ID de tu cuenta (un ID anónimo que se crea automáticamente si no has iniciado sesión), el ID del dispositivo, el juego y su versión, la versión de la aplicación, el número de compilación y el sistema operativo; el servidor lo registra y devuelve una URL de descarga válida durante 1 hora. Después de descargar, también envía a ese registro si la descarga se completó (y, si no, de qué tipo fue el fallo). Estos registros se usan para atender consultas, detectar descargas no autorizadas y contar el uso. No se envía información de los personajes, registros de juego ni la dirección de correo. Una vez descargados los datos, el juego funciona sin conexión
• Sincronización en la nube: el contenido indicado arriba en "Qué se sincroniza"
• Recepción del primer huevo y modo de prueba: para que el primer huevo (el de prueba) no se pueda recibir una y otra vez en el mismo Mac o con la misma cuenta, en el primer inicio la aplicación envía a nuestro servidor (Firebase) un hash creado a partir del identificador de hardware de este Mac (el identificador en sí nunca se envía), que se registra junto con el ID de tu cuenta (un ID anónimo creado automáticamente si no has iniciado sesión). Al empezar el modo de prueba, la hora de inicio (hora del servidor) y el mismo hash se registran en la nube de tu cuenta (el mismo lugar que la sincronización); al terminar, también la hora de fin y el motivo (si lo terminaste tú o caducó). Solo se usan para garantizar "una vez por cuenta y solo en el Mac donde empezó"; no se envían el estado de Robo ni las funciones que usaste durante la prueba
• Si activas la Conexión P2P: esta función vincula al mismo personaje entre tus propios dispositivos (requiere iniciar sesión y está desactivada por defecto; solo funciona si eliges "Vincular" cuando se te pregunta o la activas desde el menú "Conexión P2P…"). Para encontrar tus otros dispositivos, la aplicación se une a HyperDHT, una red distribuida pública en la que puede participar cualquiera. Sus nodos (los nodos de arranque de hyperdht.org y los que mantienen participantes de todo el mundo) pueden ver la dirección IP y el puerto de este equipo y su clave pública P2P (una clave aleatoria que se crea para cada dispositivo y se conserva en él; no contiene datos de tu cuenta, tu correo ni tus personajes), y el nodo que hace de intermediario al conectar también ve las direcciones IP de los dos dispositivos. Lo que intercambian los dispositivos va cifrado y los nodos no pueden leerlo. Como cualquiera puede mantener un nodo, el trato que da a lo que ve depende de quien lo mantenga
• La lista de dispositivos de la Conexión P2P: para comprobar qué dispositivos pueden conectarse, la clave pública P2P, el nombre del dispositivo (el nombre del equipo) y el sistema operativo se guardan en la nube de tu cuenta (Firebase). Al desactivar la Conexión P2P o cerrar sesión, este equipo se quita de la lista y se retira su anuncio en HyperDHT (las comprobaciones de rutas con los nodos continúan hasta que cierres la aplicación)
• Tus otros dispositivos conectados por la Conexión P2P: todo lo que se envía al otro dispositivo va cifrado. Eso incluye las direcciones IP necesarias para conectar (también las de tu red local), una presentación del dispositivo y de sus personajes (ID y nombre del dispositivo, sistema operativo y versión de la aplicación; ID, nombre y especie de cada personaje), lo que actives en "Sincronización" (las URL de los feeds RSS y si cada uno se revisa o no, el cuerpo, el nombre, el grupo y la fecha de modificación de las notas, y las asignaciones de atajos de teclado con las rutas de las apps y carpetas que abren) y, cuando un dispositivo comparte su IA con el otro, lo que se envía a esa IA (peticiones, textos, etc.) junto con sus resultados. Si un Mac comparte su SSH, también se envían su número de puerto y el nombre de usuario de este Mac, además de lo que pasa por SSH (por ejemplo, los comandos que escribes y su salida). Al conectarte desde Terminal AI Coach en el iPhone o el iPad ocurre lo mismo: el otro extremo es siempre uno de tus propios dispositivos con la misma cuenta. Una vez conectados, el tráfico circula directamente entre los dos dispositivos, sin pasar por ningún servidor ni por los nodos de HyperDHT
• Si eliges ElevenLabs para la generación de voz: el texto que se va a leer en voz alta se envía a ElevenLabs con la clave de API que introdujiste y consume tus créditos de ElevenLabs
• Si eliges Irodori-TTS + speech.cpp (local) para la generación de voz: tu texto no sale de tu equipo. Solo la primera vez que usas un modelo se conecta a Hugging Face para descargarlo
• Radio IA: para escribir el guion, los títulos y resúmenes de los artículos elegidos (y el texto de las páginas de los artículos si “Leer el artículo completo en la radio IA” está activado), junto con los nombres, la personalidad y la forma de hablar de los personajes que presentan y el modo de dirigirse al oyente, se pasan a la IA del guion (la IA de texto prestada por Conexión P2P si la hay; si no, la IA elegida en “Generación de texto” de la Configuración de IA). Cuando irían a una IA en la nube (una API compatible con OpenAI), o las voces son de ElevenLabs (el texto del guion se envía a ElevenLabs), aparece una ventana de confirmación antes de empezar, y si a mitad del programa el destino cambia a una nube que no confirmaste, no se envía nada y el programa se detiene. Con “Leer el artículo completo en la radio IA” activado (desactivado por defecto), la página de cada artículo con un resumen corto se lee una vez desde su sitio (sin enviar cookies y sin guardar el texto). Si un artículo tiene imagen, se obtiene desde la URL de la imagen que figura en el artículo
• Si eliges para la generación de imágenes un método distinto de "En el dispositivo": la petición (la descripción de la imagen que quieres) va al método elegido. "Vía MCP (Codex CLI)" y Cursor CLI la envían a OpenAI y a Cursor, respectivamente, con tu propia cuenta; la API de OpenAI y la API de Gemini, a OpenAI y a Google con la clave de API que introdujiste; y Draw Things, a la URL que configuraste (por defecto, este equipo). En Windows, cuando "Traducir la petición al inglés antes de enviarla" está activado (lo está por defecto en Draw Things), la petición también se envía a la IA elegida en Configuración de IA → Generación de texto para traducirla (en macOS se traduce en tu equipo)
• Con la integración de Claude (MCP) activada: el estado (salud, ánimo y similares) y el cuerpo de cualquier nota que le pidas leer o escribir se envían a Claude. El contenido, los datos de imagen y la ruta completa de un archivo abierto en el visor, no. Cuando Claude pide una imagen o un audio, la petición o el texto van a los mismos destinos descritos arriba para la generación de imágenes y de voz

La IA funciona de forma local por defecto. La integración con la nube es opt-in y solo se activa cuando la habilitas explícitamente en la configuración.

Las conversaciones de la Consulta no se guardan. Al terminar la sesión se borran de la memoria.

Dónde se guardan los datos

• macOS: ~/Library/Application Support/AICoach/
• Windows: %LOCALAPPDATA%\AICoach\

Los datos del lado de la nube se guardan en la región de Tokio (asia-northeast1) y no se pueden leer ni escribir desde ninguna cuenta que no sea la tuya.

Borrar los registros

También puedes borrar todos los registros. Se perderán las vidas que criaste, los linajes y la Enciclopedia completa, y todo volverá a los márgenes del principio. Esta acción no se puede deshacer.

Cesión a terceros

No los vendemos. No los entregamos. Tus registros de crianza, tus notas y tus transcripciones nunca se
venden, prestan ni ceden a terceros. No hay recogida con fines publicitarios ni rastreadores de terceros
incrustados en ninguna parte.

Lo único que sale de tu equipo son las rutas enumeradas arriba en "Lo que se envía al exterior". Salvo la
comprobación de nuevas versiones (activada de forma predeterminada; puedes detenerla con "Actualizar automáticamente" en el menú), la descarga de los datos de los juegos que aprenden tus compañeros y el registro del primer huevo en el primer inicio, cada una funciona solo si la activas tú. Lo que se envía se trata según los términos y la política de privacidad de cada destinatario.

Salvo cuando la ley nos obligue a revelarlos.

Cuánto tiempo se conservan

Desinstalar la aplicación no borra las carpetas anteriores. Para dejarlo todo limpio, ejecuta "Borrar los
registros" o elimina tú mismo esas carpetas.

Contacto

Para cualquier consulta sobre privacidad y tratamiento de datos, usa el formulario de contacto del sitio o
escribe a contact.aicoach@gmail.com.

---

12. Idiomas admitidos

Se admiten 5 idiomas: 日本語 / English / 简体中文 / 繁體中文 / Español.

El idioma de la interfaz se elige automáticamente según el idioma del sistema operativo.

• macOS: Configuración del Sistema → Idioma y región
• Windows: Configuración → Hora e idioma → Idioma

En entornos con un idioma no admitido, la interfaz se muestra en inglés.

---

13. Requisitos del sistema

Algunas funciones requieren conexión a internet. La sincronización utiliza Firebase. La versión de macOS es solo para Apple Silicon. La versión para Windows está en desarrollo y llegará próximamente; todavía no se distribuye.

Diferencias entre la versión de macOS y la de Windows

En la versión de Windows, las siguientes funciones aún no están disponibles. Las iremos incorporando progresivamente.

• Consulta
• Vinculación de cuenta y sincronización en la nube
• Los atajos de teclado del historial del portapapeles, los marcadores y el RSS (sí están disponibles desde el menú)
• Generación de imágenes con IA
• Algunas escenas

---

14. Si tienes problemas

El personaje no aparece
Abre "Administrar personajes" desde la barra de menús (macOS) o la bandeja del sistema (Windows) y comprueba si está guardado. Si se convirtió en fantasma, también puedes volver a llamarlo desde los personajes guardados.

El huevo no eclosiona
Los huevos eclosionan solo con el paso del tiempo. No necesitan comida. Mientras está guardado el tiempo no avanza, así que déjalo en pantalla y espera.

La entrada de voz no responde

1. Si todavía es un huevo, la entrada de voz no se desbloquea hasta que eclosione (por diseño)
2. Comprueba que el permiso del micrófono esté concedido
3. Comprueba que estés presionando el Shift derecho durante 0,3 segundos o más (si es más corto, no responde)
4. Comprueba que ninguna otra aplicación esté ocupando el Shift derecho de forma exclusiva

El resultado de la transcripción no se escribe en otras aplicaciones
La escritura automática requiere el permiso de accesibilidad. Concédelo en la configuración. Comprueba también que la opción de escritura automática esté activada.

La IA no responde
Revisa el endpoint y el nombre del modelo en la configuración de IA. Si usas llama.cpp, la longitud de contexto debe ser de 8192 o más. Cuando no hay respuesta, se cambia automáticamente a las frases habituales.

Los huevos que compré no llegan
Reinicia la aplicación y revisa la Bandeja de incubación. Si aun así no llegan, contáctanos indicando la dirección de correo electrónico que usaste al comprar.

Los datos no se transfieren al otro dispositivo
Comprueba que hayas iniciado sesión con la misma cuenta de Google / correo electrónico en los dos dispositivos. La sincronización se activa en las cuentas que han comprado uno o más huevos.

La enfermedad no se cura
"Cuidar" solo tiene efecto una vez por hora. Si la inmunidad es alta, se irá recuperando de forma natural. Aliméntalo bien y deja que duerma como corresponde.

Claude no encuentra AI Coach
Comprueba que AI Coach esté en ejecución y que la integración esté habilitada. Los datos de conexión se regeneran en cada inicio de la aplicación, así que reiniciar AI Coach una vez suele resolverlo. En "Conectar con Claude", dentro de "Configuración de IA" → "Conectar", también puedes comprobar si ya está añadido.

No puedo añadirlo a Claude Code
Para registrar AI Coach en Claude Code necesitas Node.js 22 o posterior en tu PATH. Claude Desktop se puede conectar aunque no tengas Node.js.

Se lo pedí a Claude, pero no pasó nada
No se muestra nada en un personaje dormido, un huevo, un fantasma ni uno guardado, y lo mismo vale durante la consulta, una conversación o una transcripción. Saca a otro personaje e inténtalo de nuevo.

El aviso de "trabajando" se queda en pantalla
Se borra solo como máximo a los 15 minutos. Para quitarlo antes, dile a Claude que el trabajo terminó o guarda a ese personaje una vez.

El anillo no aparece al mantener presionada fn
Comprueba que la mantengas presionada durante 0,3 segundos o más. Si la presionas junto con otra tecla, funciona como un atajo normal. Si el anillo todavía no tiene ningún elemento, elígelos en "Lanzador circular…", dentro de Configuración en la barra de menús. Comprueba también el permiso de accesibilidad.

"Crear imagen con IA…" no aparece en el menú
Puede que tu compañero aún no haya aprendido la generación de imágenes con IA, o que el método elegido en "Imágenes" de la Configuración de IA no se pueda usar en este Mac. "En el dispositivo" solo funciona en Mac compatibles con Apple Intelligence.

"Crear voz con IA…" no aparece en el menú
En "Voz" de la Configuración de IA, deja un método listo para usar y guárdalo (ElevenLabs necesita una clave de API, e Irodori-TTS + speech.cpp, el comando speech).

Con la Conexión P2P, el otro Mac no aparece en la lista
Comprueba que hayas iniciado sesión con la misma cuenta en los dos Mac y que hayas activado "Conexión P2P…" en ambos.

---

Contacto

Si no logras resolverlo, contáctanos a través del formulario de consultas del sitio.
Te invitamos a consultar también las preguntas frecuentes.

Languages

• 日本語
• English
• Español
• 简体中文
• 繁體中文

AI Coach