Ageaf PPAD

Agente de IA dentro de Overleaf: corrige, reescribe y revisa tu LaTeX sin salir del editor.

Este es un fork. Ageaf PPAD se basa en Ageaf de OniReimu, publicado con licencia MIT. Está adaptado para overleaf.ppad.cl, con cambios de seguridad e instaladores para Linux, macOS y Windows. Si tienes problemas con esta versión, repórtalos a PPAD, no al proyecto original.

Requisitos

Google Chrome, Chromium, Edge, Brave o Firefox 128 o superior.
Una de estas opciones para el modelo de IA:
- Claude Code instalado, con sesión iniciada. Ejecuta claude y luego /login.
- Codex CLI instalado, con sesión iniciada.
- Una clave de API (Anthropic, OpenAI, Gemini…) en el archivo de configuración.

No hace falta instalar Node.js: el paquete trae su propio Node.

Instalación

1. Instala el programa local

Descarga el paquete de tu sistema desde Descargas y descomprímelo.

Sistema	Qué hacer
Linux / macOS	Abre una terminal en la carpeta y ejecuta `./install.sh`.
Windows	Haz doble clic en `install.cmd`.

El instalador no pide permisos de administrador. Al terminar, muestra la ruta de la extensión que usarás en el paso 2.

2. Instala la extensión del navegador

Chrome, Edge y Brave

Abre chrome://extensions y activa Modo de desarrollador.
Pulsa Cargar descomprimida y elige la carpeta extension que indicó el instalador.

Firefox

Arrastra el archivo ageaf-ppad-firefox.xpi firmado a una ventana de Firefox y acepta los permisos.
Si el Firefox de Ubuntu pregunta si puede iniciar Ageaf, acepta.

3. Úsalo

Abre un proyecto en overleaf.ppad.cl. El panel de Ageaf aparece a la derecha. Si no aparece, recarga la página por completo con Ctrl+Shift+R.

Uso

Elige el proveedor (Anthropic, OpenAI o BYOK) y escribe tu pedido. Por ejemplo: "revisa la redacción de la introducción".
Selecciona un párrafo en el editor y pulsa Ctrl+L para enviárselo al panel.
Ageaf propone los cambios como parches, y tú los aceptas o rechazas uno por uno.
Con @ mencionas archivos del proyecto; con / ves los flujos disponibles.

Seguridad

Por defecto, el panel está en modo Safe: antes de ejecutar un comando o modificar archivos en tu computador, Claude te pregunta en el panel (Allow / Deny). El modo YOLO quita esas preguntas. Actívalo solo si confías en el contenido del documento, porque un texto malicioso dentro del documento podría pedirle al agente acciones dañinas.

El contenido que compartes con el agente se envía al proveedor de IA que elegiste.

Problemas frecuentes

Síntoma	Solución
El panel no aparece, o no responde al hacer clic	Recarga la página con `Ctrl`+`Shift`+`R`. Después de actualizar o recargar la extensión, siempre hay que recargar la pestaña.
"Host not running"	Vuelve a ejecutar el instalador. En Firefox snap o flatpak, acepta la ventana del sistema que pregunta si Firefox puede iniciar Ageaf.
"Claude Code CLI not working"	Abre una terminal y ejecuta `claude` para iniciar sesión.
Firefox: "no se puede leer ni cambiar datos en este sitio"	En el menú Extensiones (ícono de pieza de puzle), permite que Ageaf PPAD acceda al sitio.