Documentación
Instalar y entender
Instalación
Descargue el archivo, arrastre AItention.app a
Applicationsy ábrala. La aplicación está firmada con un Developer ID y notarizada por Apple: no aparece ninguna advertencia.
Los hooks de estado
Sin hooks, la aplicación puede listar qué sesiones se ejecutan, pero no
qué hacen. En el primer arranque ofrece configurarlos: añade entradas en ~/.claude/settings.json que llaman a un programa incluido. Ese programa escribe un archivo de estado y nada más.
Antes de cada cambio en ese archivo se crea una copia de seguridad. Todas las entradas están marcadas con
# aitention para que al quitarlas nunca se toquen hooks configurados por usted:
~/Applications/AItention.app/Contents/MacOS/AItention --uninstall-hooks
Los estados
| Estado | Significado |
|---|---|
| Decisión | Claude ha hecho una pregunta con opciones. |
| En espera | Hay una consulta o un permiso pendiente. |
| Error | El turno falló por un error de API: sobrecarga, límite de tasa, facturación. |
| Listo | El turno terminó, la respuesta está sin leer. |
| Trabajando | Hay una instrucción en curso, se ejecutan herramientas. |
| Preparada | Sesión abierta, ningún turno activo. |
| Inactiva | Terminada, pero reanudable con claude --resume. |
Si una sesión que trabaja calla más de treinta minutos, pierde su color y muestra cuánto lleva en silencio. Una indicación caducada que parece segura induce a error de forma más cara que una que admite no saber.
De dónde vienen los datos
Todo lo que muestra la aplicación procede de estos archivos. Nada de ello sale del equipo.
| Archivo | Para qué |
|---|---|
~/.claude/sessions/<pid>.json | Qué sesiones se ejecutan, su directorio de trabajo y su origen |
~/.claude/aitention/status/<id>.json | El estado en vivo, escrito por el hook: el único archivo que AItention crea |
~/.claude/projects/…/<id>.jsonl | Transcripciones: respuestas, llamadas a herramientas, tokens |
~/.claude/tasks/<id>/ | La lista de tareas de una sesión, si mantiene alguna |
~/Library/Application Support/Claude/… | Título, modelo y modo de las sesiones de escritorio, además del uso de los límites |
Activar una licencia
Tras la compra recibe un correo con un botón que abre la aplicación e introduce la licencia. Si no funciona: Ajustes → Licencia → pegar la clave → Activar. No se establece ninguna conexión.
Cuando algo no encaja
La salida de diagnóstico muestra lo que ve la aplicación sin abrir la interfaz, incluidas todas las rutas y el estado de los hooks:
~/Applications/AItention.app/Contents/MacOS/AItention --dump
Para comprobar una clave de licencia: --verify-licence <key>