FAQ
/// lo que sale al instalar
¿Necesito la nube o puedo trabajar en local?
Las dos. Hay 22 presets; Ollama, LM Studio, vLLM, SGLang y cualquier servidor compatible con OpenAI se configuran con el mismo asistente que Grok o Claude. El presupuesto se calcula con las sesiones de tu disco. Si el modelo está en tu máquina, de ahí no sale nada que tú no hayas pedido.
¿Qué diferencia hay entre un pack y un paquete?
Un pack es un ámbito de trabajo: un directorio de packs/ con su manifiesto, su contexto inyectable, sus skills y sus prompts. Es lo que el radar detecta y lo que habilitas con /domains. Un paquete es algo que se instala: lo que llega por pi install, la galería o /essentials. Los packs vienen dentro del paquete Alfred-Pi. Los paquetes recomendados de cada pack se instalan aparte, con auditoría previa. Nada se instala en silencio. Si una skill cita un paquete muerto, un test guardián lo impide resucitar.
¿Chrome para mejorar y las pruebas e2e no son lo mismo?
No, y la diferencia importa. La skill e2e-testing escribe la suite de Playwright que corre en CI: especificaciones regenerables que vigilan que los flujos sigan vivos. La skill browser-improve conduce Chrome por CDP para medir y arreglar la página viva: rendimiento, capturas, estados reales. Una escribe el contrato que se verifica solo; la otra mira la página con tus ojos. Ninguna conduce tu Chrome sin autorización expresa, y ninguna sustituye a la auditoría de accesibilidad del pack Compliance.
Tengo la 0.2.x instalada: ¿qué pasa al actualizar a 0.3.0?
Tu casa se muda sin perder los muebles. El primer arranque tras actualizar comprueba si existe ~/.pi/agent/alfred-pi/. Si no existe y sí el viejo pi-harness-moe/, lo copia, no lo mueve, y deja un migrated-from.json con la fecha. La lectura prueba primero el nombre nuevo y luego el viejo. La escritura, una vez migrado, solo toca el nuevo. Tus archivos nativos de pi no los toca la migración. El origen no se borra en 0.3.0.
Mis scripts usan --harness-moe: ¿siguen funcionando?
En 0.3.0, sí. El flag viejo responde durante un ciclo completo y el doctor avisa de que el canónico es --alfred-pi. En 0.4.0 el alias se retira, así que el momento de cambiar los scripts es este ciclo, con el aviso del doctor como recordatorio. Los valores del flag no cambian: doctor, usage, stack,autopilot, domains y las variantes:json.
¿Alfred-Pi recuerda cosas entre sesiones?
Solo si tú se lo pides, y proyecto a proyecto. La memoria se activa con un archivo .alfred-pi/memory-policy.json en tu repositorio que contenga { "allow": true }. Si el archivo no existe o no se puede leer, la memoria está apagada. Nunca se enciende sola. Tras la mudanza de nombre, si la política nueva no existe se respeta la vieja .pi-harness-moe/memory-policy.json.
¿El presupuesto me corta si me paso del tope diario?
No. El tope es de aviso: al 80 % te avisa una vez al día y al 100 % añade una nota de frugalidad al system prompt (respuestas cortas, nada de lanzar flotas sin preguntar). Observa y modula. Jamás bloquea un turno. El relevo tampoco salta por precio: salta por fallo del proveedor, entre turnos.
¿Qué es pi y dónde lo consigo?
pi es el agente de terminal sobre el que se instala Alfred-Pi. Sin pi no hay extensión que cargar. La instalación oficial está en pi.dev; Alfred pide la 0.84 o superior. Si ya lo tienes, el comando del hero y un /reload bastan.
¿Es un clon de Claude Code?
No. Claude Code es un agente completo de otro fabricante. Alfred-Pi es la capa de producto sobre pi, el anfitrión que tú ya tienes: gobierna sus archivos nativos con diff, backup y escritura atómica, y añade packs, presupuesto, relevo y auditoría. El comando /essentials ofrece paridad de piezas con los agentes grandes (paquetes curados y auditados), pero la casa, el modelo y las claves son tuyos.
¿Cuánto cuesta?
Alfred-Pi es MIT y gratis. Pagas los modelos que uses, al proveedor que elijas, con las claves que tú guardas. El harness te ayuda a ver ese gasto (/usage, tope diario) y a no descubrirlo a final de mes. No hay plan, no hay telemetría de producto, no hay cuenta en la nube del estudio.