Desarrolladores
Instalación rápida
Instala, configura e inicia tu agente. Elige la instalación local para una máquina o sigue los pasos de servidor compartido para un equipo.
Solo yo
Instala un binario, deja que arranque un servidor local y lanza tu agente. El servidor se enlaza a 127.0.0.1:49374, así que nada fuera de esta máquina puede llegar a él. Una instalación nueva guarda su token en un archivo accesible solo para su dueño, que leen los hooks y la CLI, así que no escribes ninguno.
Instala el binario
El script descarga la versión para tu sistema y tu chip, la verifica contra el archivo
.sha256publicado y se niega a instalar si no coincide. Enlaza~/.local/bin/ai-memoryy no necesita root.Terminal curl -fsSL https://github.com/akitaonrails/ai-memory/releases/latest/download/install.sh | shConfigúralo
setupcrea el directorio de datos y el token, inicia un servicio de usuario y conecta los agentes seleccionados. Usasetup --planpara revisar sin cambios, osetup --webpara elegir agentes en una página local del navegador.Terminal ai-memory setupLanza tu agente a través de él
Reinicia tus agentes una vez. Lanzar
claudedirectamente sigue funcionando después.Terminal ai-memory run claude
Instala el binario
mise descarga el archivo de la versión para tu sistema y tu chip, y lo verifica contra el archivo
.sha256publicado. No necesita el toolchain de Rust ni Docker.Terminal mise use -g github:akitaonrails/ai-memoryCrea el directorio de datos y arranca el servidor
initcrea el directorio de datos y su archivo de token.servetiene que seguir corriendo, así que dale su propia terminal. Solo escucha en esta máquina, y los hooks y la CLI leen el token del directorio de datos.Terminal ai-memory init ai-memory serve --transport http --bind 127.0.0.1:49374Lanza tu agente a través de él
El primer lanzamiento de un harness instala sus hooks y su entrada MCP si faltan. Lanzar
claudedirectamente sigue funcionando después.Terminal ai-memory run claude
Instala el paquete
El paquete
-bines un binario precompilado para x86_64 o aarch64. Los dos paquetes traen una unidad de usuario y una unidad de sistema para systemd.Terminal yay -S ai-memory-bin # binario precompilado para Linux x86_64/aarch64 yay -S ai-memory # compila desde el código fuenteCrea el directorio de datos
Terminal mkdir -p ~/.config/ai-memory ~/.local/share/ai-memory ai-memory --data-dir ~/.local/share/ai-memory \ --config ~/.config/ai-memory/config.toml initArranca el servicio de usuario
No necesita sudo, y todo el estado se queda en tu directorio home. La sección de servicios cubre la unidad de sistema y cómo seguir corriendo después de cerrar sesión.
Terminal systemctl --user enable --now ai-memory.serviceLanza tu agente a través de él
Terminal ai-memory run claude
Instala el paquete
Descarga el RPM x86_64 o aarch64 desde la página de la versión. Trae el binario, las fuentes de los hooks y las unidades de systemd.
Terminal sudo dnf install ./ai-memory-*.rpmCrea el directorio de datos
Terminal mkdir -p ~/.config/ai-memory ~/.local/share/ai-memory ai-memory --data-dir ~/.local/share/ai-memory \ --config ~/.config/ai-memory/config.toml initArranca el servicio de usuario
No necesita sudo, y todo el estado se queda en tu directorio home. La sección de servicios cubre la unidad de sistema y cómo seguir corriendo después de cerrar sesión.
Terminal systemctl --user enable --now ai-memory.serviceLanza tu agente a través de él
Terminal ai-memory run claude
Descarga y descomprime
Este archivo es para Apple Silicon. En un Mac con Intel, cambia
aarch64porx86_64. Una descarga hecha con el navegador necesitaxattr -d com.apple.quarantine ./ai-memoryuna vez. Una descarga con curl no.Terminal mkdir -p ~/Applications/ai-memory && cd ~/Applications/ai-memory curl -fsSL -O https://github.com/akitaonrails/ai-memory/releases/latest/download/ai-memory-macos-aarch64.tar.gz tar -xzf ai-memory-macos-aarch64.tar.gzCrea el directorio de datos y arranca el servidor
Deja
servecorriendo en esta terminal. Como alternativa, el agente de launchd lo arranca al iniciar sesión.Terminal ./ai-memory init ./ai-memory serve --transport http --bind 127.0.0.1:49374Lanza tu agente a través de él
Deja el binario descomprimido donde está, porque los hooks que instala el primer lanzamiento apuntan a esa ruta.
Terminal cd ~/Applications/ai-memory ./ai-memory run claude
Instala el script wrapper
El wrapper es un script de shell pequeño que queda en
~/.local/bin/ai-memory. El README tiene el script de instalación, que verifica la descarga contra su archivo SHA-256 antes de instalarla. Cópialo de ahí.Arranca el servidor
La imagen cubre
linux/amd64ylinux/arm64. En un host con Podman, cambiadockerporpodman. El wrapper usa Podman rootless por su cuenta cuando Docker no está instalado.Terminal docker run -d --name ai-memory \ --restart unless-stopped \ -p 127.0.0.1:49374:49374 \ -v ai-memory-data:/data \ docker.io/akitaonrails/ai-memory:latestLanza tu agente a través de él
El primer inicio configura hooks y MCP. En Linux/macOS, el wrapper usa un cliente nativo verificado en el host para la instalación normal de hooks. Los hooks antiguos de shell elegidos explícitamente no aplican exclusiones de captura por repositorio.
Terminal ai-memory run claude
Instala desde PowerShell
Windows nativo sigue siendo experimental. El script verifica el checksum del zip, instala en
%LOCALAPPDATA%\Programs\ai-memoryy lo añade al PATH del usuario, sin permisos de administrador. Para un agente en WSL2, sigue los pasos de Linux dentro de esa distribución. Guía de Windows. Scoop instala el mismo zip desde el bucket del mantenedor; la página de descarga tiene los dos comandos.Terminal irm https://github.com/akitaonrails/ai-memory/releases/latest/download/install.ps1 | iexConfigúralo
setupcrea el directorio de datos y el token, conecta los agentes detectados e inicia un servidor sin ventana ahora y en cada inicio de sesión. Funciona mientras estés conectado y se reinicia tras fallos, con un límite de reintentos.Terminal ai-memory setupReinicia tus agentes
Pregunta a un agente qué recuerda de este proyecto. Para ejecutar el servidor antes de que alguien inicie sesión, usa la receta de WinSW de la guía de Windows.
Instala
Arranca el servidor
127.0.0.1:49374
Lanza tu agente
hooks / MCP
ai-memory run es la forma de iniciar un agente. Conecta el harness en el primer lanzamiento, elige el scope de proyecto correcto y añade la reanudación de sesiones entre harnesses. Un agente iniciado directamente también captura mediante sus hooks, pero no te olvidas de nada si pasas por el lanzador. Lee cómo funcionan los lanzamientos gestionados.
Comprueba que funciona
Tres comprobaciones, desde la red hasta el agente.
El servidor responde
En una instalación nueva con autenticación, esta petición sin credenciales debe devolver HTTP 401 con “auth required”. Solo demuestra que el servidor es accesible. La siguiente comprobación prueba el acceso autenticado de la CLI.
curl -i http://127.0.0.1:49374/mcp
La CLI llega a él
La CLI es un cliente HTTP ligero. Si esto imprime un estado, los hooks también pueden llegar al servidor.
ai-memory status
El agente recuerda
En un proyecto sin datos sensibles, pide al primer agente que guarde una decisión concreta del proyecto. Termina la sesión, inicia otro agente compatible en el mismo directorio y pídele esa decisión y la página guardada que la respalda.
“¿Qué decisión del proyecto guardé y qué página de memoria la registra?”
Después del primer agente
Las tres cosas son opcionales. Hazlas cuando las necesites.
Añade otro agente
Lánzalo una vez a través de ai-memory y queda conectado. A partir de ahí, los dos agentes comparten una misma memoria del proyecto.
ai-memory run codex
Opcional: mejores resúmenes con un LLM
La captura, la búsqueda y los resúmenes por reglas funcionan sin proveedor. Al añadir uno se habilitan resúmenes más completos y automejora programada, que aplica automáticamente las ediciones validadas por defecto. En servidores compartidos configura [auto_improve] require_approval = true. Define las variables siguientes en el entorno del servidor y reinícialo.
AI_MEMORY_LLM_PROVIDER=anthropic
ANTHROPIC_API_KEY=sk-ant-...
Compara proveedores, incluidas suscripciones y modelos locales
Deshazlo todo
Esto quita solo lo que instaló ai-memory. Los comandos de instalación son idempotentes, y cada uno escribe una copia de seguridad con marca de tiempo junto a cada archivo que toca.
ai-memory uninstall --apply
Mi equipo
Un servidor al que llegan todas las máquinas y todos los compañeros de equipo. No hay replicación entre servidores: memoria compartida significa que todos se conectan al mismo.
alice
bob
carol
Un servidor compartido
Token
Una wiki para el equipo
Una clave por persona
Inicia el servidor detrás de un proxy local
Instala primero la CLI nativa en el host del servidor. Estos comandos publican Docker solo en loopback y configuran las credenciales root de la CLI en este shell. Sustituye
memory.example.compor tu dominio. Mantén privado el token root; los portátiles recibirán claves individuales después.en el servidor ROOT_TOKEN=$(ai-memory generate-auth-token) export AI_MEMORY_SERVER_URL="http://127.0.0.1:49374" export AI_MEMORY_AUTH_TOKEN="$ROOT_TOKEN" docker run -d --name ai-memory \ --restart unless-stopped \ -p 127.0.0.1:49374:49374 \ -v ai-memory-data:/data \ -e AI_MEMORY_AUTH_TOKEN="$ROOT_TOKEN" \ -e AI_MEMORY_AUTH__SECURE_COOKIE=true \ -e AI_MEMORY_ALLOWED_HOSTS="memory.example.com,localhost,127.0.0.1" \ akitaonrails/ai-memory:latestConfigura y verifica TLS antes de conectar clientes
Coloca un proxy inverso en el mismo host, reenviando HTTPS de tu dominio a
127.0.0.1:49374. Sigue la configuración de TLS y verifica el certificado desde un portátil antes de enviar claves. Un token bearer autentica; no cifra el tráfico.Crea a las personas
Usa el shell del servidor donde siguen exportadas las variables de root. La contraseña temporal se muestra una vez y debe cambiarse al iniciar sesión. Este comando no emite una clave API. La guía de usuarios cubre la identidad root y el acceso desde el navegador.
Terminal ai-memory user add-human --username alice --email alice@home --name "Alice Smith"Dale a cada persona una clave de API
El secreto
aim_se muestra una sola vez.ai-memory api-key rotate <id>yai-memory api-key revoke <id>surten efecto de inmediato.Terminal ai-memory api-key add --username alice --label codex-laptopApunta cada máquina al servidor
Instala la CLI en cada portátil. Sustituye el dominio y la clave siguientes por tu endpoint HTTPS y la clave emitida para esa persona. En Unix, el instalador de hooks guarda el token en un archivo accesible solo al propietario; los comandos generados no lo contienen.
--as-useretiqueta la instalación y no concede permisos.en cada portátil # Sustituye el ejemplo por la clave aim_ emitida para esta persona; nunca uses ROOT_TOKEN USER_API_KEY='aim_REPLACE_WITH_ISSUED_KEY' export AI_MEMORY_SERVER_URL="https://memory.example.com" export AI_MEMORY_AUTH_TOKEN="$USER_API_KEY" ai-memory install-mcp --client claude-code --apply ai-memory install-hooks --apply --agent claude-code \ --as-user alice --auth-token "$USER_API_KEY" # luego lanza como siempre ai-memory run claude
¿Atascado en un paso?
El cookbook de instalación en GitHub tiene los comandos por agente, los servidores remotos y Windows. El issue tracker está abierto.