Introducción

Llevo mes y medio trabajando en un proyecto que cada vez me engancha más. Se llama Pillbox, y es una capa de memoria persistente para agentes de inteligencia artificial.

Si llevas tiempo usando herramientas de programación agéntica, sabrás de lo que hablo cuando digo que el mayor punto débil de estas herramientas no es la calidad del modelo, ni el contexto disponible, ni la velocidad. Es que cada sesión empieza de cero. El agente no recuerda tu proyecto. No sabe qué decidiste la semana pasada, ni por qué descartaste aquella arquitectura, ni que tienes preferencia por cierto patrón. Eres tú quien tiene que ponerse al día, sesión tras sesión, repitiendo el mismo contexto una y otra vez.

Pillbox nació para resolver eso. En este artículo quiero contarte qué problema concreto resuelve, cómo funciona la metáfora que lo articula, la filosofía detrás y hacia dónde va el proyecto.

El problema real: el agente de ayer no sabe nada de hoy

Si te digo que los agentes de IA son stateless por defecto, probablemente ya lo sabes. Pero conviene pensar un momento en lo que eso significa en la práctica.

Cada vez que abres una sesión nueva con tu asistente de código, el agente llega a tu proyecto sin ningún recuerdo. Puede leer tus archivos, analizar tu estructura y entender lo que hay. Pero no sabe qué hay detrás de cada decisión. No recuerda que la semana pasada estuviste tres horas depurando un bug relacionado con las transacciones de la base de datos y que encontraste una solución no obvia. No sabe que prefieres evitar ciertas dependencias porque ya te dieron problemas en otro proyecto. No sabe que estás en mitad de una refactorización y que la mitad del código aún no refleja la arquitectura que tienes en mente.

Todo ese conocimiento existe en tu cabeza. Y cada nueva sesión, tienes que transferirlo de nuevo, parcialmente, mal, con prisa. O directamente no lo haces, y el agente toma decisiones sin ese contexto.

Si ya has trabajado con agentes de verdad, con proyectos de cierta envergadura y durante semanas seguidas, reconocerás la frustración. Como hablé en mi artículo sobre programación agéntica, la diferencia entre usar la IA como una herramienta profesional o como un generador de código aleatorio está en la calidad del contexto que le das. Pillbox trata de automatizar y hacer persistente exactamente esa parte.

La metáfora del pastillero

Los nombres técnicos me importan más de lo que puede parecer. Un buen nombre no es solo marketing, es claridad conceptual. Cuando algo tiene un nombre que encaja con lo que hace, resulta más fácil de entender, de recordar y de usar.

Pillbox es, literalmente, un pastillero. Esa cajita dividida en compartimentos que usas para organizar las pastillas de la semana. El nombre llegó pronto y se quedó, porque la metáfora funciona sola.

Los conceptos principales del sistema son:

• Bottle (frasco): un proyecto. Así como un frasco de medicamento contiene las pastillas para un tratamiento concreto, un bottle agrupa todo el conocimiento asociado a un directorio de trabajo.
• Prescription (receta / prescripción): una sesión de trabajo dentro de un proyecto. Igual que una prescripción médica define un tratamiento con un propósito concreto, una prescription tiene un título que describe la tarea que se está llevando a cabo.
• Pill (pastilla): una pieza de conocimiento específico del proyecto guardada dentro de una prescription. Una decisión arquitectónica, un bug y su causa raíz, un patrón establecido, un hallazgo no obvio.
• Capsule (cápsula): conocimiento personal y transversal, no ligado a ningún proyecto. Tus preferencias de trabajo, tu entorno, tus convenciones, tus objetivos a largo plazo. Las cápsulas están disponibles en todos los proyectos.

La metáfora funciona porque el modelo mental es inmediato: tienes frascos por proyecto, recetas por sesión de trabajo, y dentro guardas las pastillas de conocimiento que el agente va acumulando. Es sencillo de explicar y de recordar.

Cómo funciona en la práctica

La clave de diseño de Pillbox es que el usuario no tiene que hacer nada manualmente. No hay un comando “guarda esto” ni una lista de cosas que recordar. El agente es quien decide qué merece la pena conservar, siguiendo un criterio parecido al que usaría un buen ingeniero tomando notas mientras trabaja.

El flujo es así:

Cuando empiezas a trabajar en un proyecto, el agente abre una prescription con un título que describe la tarea. Al mismo tiempo, carga el contexto de sesiones anteriores: qué se hizo, qué se decidió, qué está pendiente. Durante el trabajo, el agente va guardando pills de forma autónoma: una decisión importante, la causa de un bug difícil, un patrón que se establece para el proyecto. Al terminar, cierra la prescription.

La próxima vez que trabajes en ese proyecto, el agente arranca con todo ese contexto disponible. Sin que tengas que explicar nada. Sin copiar y pegar contexto en cada sesión. El agente ya estaba.

pillbox bottle init      # Inicializa el proyecto
pillbox status           # Estado global del sistema
pillbox serve start      # Inicia el servidor HTTP (interfaz web)

Además del CLI, Pillbox expone un servidor MCP que permite a herramientas como Claude Code interactuar directamente con el sistema de memoria. Y hay una interfaz web para revisar y gestionar el conocimiento acumulado: los frascos, las prescripciones, las píldoras.

La filosofía: el agente que “ya estaba”

Hay una frase en la documentación del proyecto que define muy bien la intención de Pillbox: “the agent that was already there”. El agente que ya estaba.

No me interesa un sistema donde el usuario tenga que gestionar la memoria de su agente como si fuera una base de datos. No quiero que alguien tenga que pensar “¿debo guardar esto?”. Ese overhead cognitivo es exactamente lo que Pillbox quiere eliminar.

La memoria tiene que ser proactiva, no reactiva. El agente observa, decide y guarda. Lo mismo que haría un buen compañero de trabajo que toma notas sin que se lo pidan, porque entiende qué información va a ser valiosa más adelante.

Esto implica un cambio de paradigma sutil pero importante. No estás usando una herramienta de notas. Estás trabajando con un agente que construye su propio modelo del proyecto y de la persona con la que trabaja, de forma incremental, sesión a sesión.

Inspiración: Engram de Gentleman Programming

No quiero hablar de Pillbox sin mencionar de dónde vino la chispa inicial. Descubrí Engram, el proyecto de Gentleman Programming, mientras investigaba soluciones al problema de la memoria en agentes. Fue un momento de “esto es exactamente lo que necesito” inmediato.

Engram demostró que la idea era válida y que había demanda real para este tipo de herramienta. Pero cuanto más lo usé y más pensé en cómo lo haría yo, más claro tuve que quería construir algo con una visión propia: una arquitectura diferente, una metáfora más clara, más capacidades y construido en Rust desde el núcleo. No como fork, sino como un proyecto nuevo con sus propias decisiones de diseño.

Eso es Pillbox. Inspirado en la dirección, pero construido desde cero con criterio propio.

Próximamente

Pillbox está en desarrollo activo. Hay un roadmap definido y el proyecto avanza.

No voy a dar fechas concretas porque detesto las fechas que no se cumplen 😅 Lo que sí puedo decir es que el núcleo está construido y funcionando, que el propio desarrollo de Pillbox usa Pillbox para gestionarse, y que la versión pública está más cerca que lejos.

Cuando esté lista para el lanzamiento público, habrá anuncio. Si tienes curiosidad y quieres estar al tanto, la mejor forma es seguirme en LinkedIn o en GitHub. No vendo nada ni tengo newsletter: simplemente comparto lo que construyo.

Conclusión

Pillbox nació de una frustración concreta con una solución concreta. Los agentes de IA son extraordinariamente potentes, pero stateless por defecto. Darles memoria persistente, estructurada y buscable cambia la experiencia de trabajar con ellos de una forma que, una vez que la pruebas, no quieres volver atrás.

La metáfora del pastillero — bottle, prescription, pill, capsule — no es solo un nombre bonito. Es un modelo mental que hace que el sistema sea fácil de entender y de razonar. Y la filosofía del agente que “ya estaba” es el objetivo real: no una herramienta de notas más, sino un agente que construye contexto de forma autónoma y lo usa cuando lo necesita.

Si trabajas con agentes de IA y reconoces el problema que he descrito, Pillbox está pensado para ti. Seguiré publicando actualizaciones del proyecto aquí en el blog a medida que avance 😎

✕