Memorix

Memorix

Capa de memoria compartida local-first para agentes de codificación con IA.
Un sistema de memoria de proyecto para Claude Code, Codex, CodeBuddy Code, Cursor, Windsurf, Copilot, Gemini CLI, OpenCode, Grok Build, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, DeepSeek Harness, WorkBuddy y cualquier agente compatible con MCP.

Listado en el Registro oficial de MCP

Memoria de Proyecto Compartida | MCP | Memoria Git | Memoria de Razonamiento | Complementos | Orquestación

Sitio web | Chino | Instalación | Capacidades | Agentes | Inicio rápido | Modelo de memoria | memcode | Trabajo activo | Documentación

---

El estado del mantenedor y el límite público del trabajo actual viven en ACTIVE_WORK.md. Es el único rastreador de trabajo vivo del repositorio.

Memorix les da a los agentes de codificación con IA que ya usas una memoria de proyecto compartida y buscable que sobrevive a nuevos chats, cambios de IDE, sesiones de terminal y traspasos. La memoria vive bajo el proyecto Git, no dentro de una ventana de chat ni de una herramienta.

Usa Claude Code hoy, Codex mañana y Cursor por la tarde. El agente puede cambiar; la memoria del proyecto permanece igual.

Usa Memorix cuando sigas reexplicando el mismo proyecto a una nueva sesión de agente: la última sesión ya descubrió algo, otro IDE no puede verlo, o una decisión de diseño está enterrada en un chat que ya no puedes encontrar.

Problema	Qué aporta Memorix
La siguiente sesión olvida lo que aprendió la anterior	Memoria con alcance de proyecto, resúmenes de sesión, líneas de tiempo y recuperación de detalles
Diferentes agentes saben cosas distintas	Un único grupo de memoria local disponible mediante MCP, hooks, CLI, SDK y el agente de terminal incluido
Git registra qué cambió, pero los agentes no pueden recordarlo bien	Git Memory convierte los commits en hechos de ingeniería buscables
Las decisiones de arquitectura desaparecen en chats antiguos	Reasoning Memory almacena por qué se tomaron las decisiones, con alternativas y compensaciones
Los archivos de reglas estáticos se desactualizan	Gotchas, correcciones y habilidades del proyecto evolucionan a partir del trabajo real
El trabajo paralelo de agentes se vuelve desordenado	memorix orchestrate coordina el contexto de tareas, traspasos, bloqueos, verificación y bucles de revisión

Memorix es local-first. SQLite es el almacén canónico. Los proyectos pequeños usan la ruta Orama en proceso; los proyectos más grandes usan un índice candidato SQLite FTS5 persistente y, cuando está disponible, un índice de sombra semántico LanceDB local opcional. Ambos índices son reconstruibles y nunca son un límite en cuántos recuerdos duraderos puedes conservar. La formación y la incrustación respaldadas por LLM siguen siendo opcionales.

Capacidades

Memorix es más que un almacén de memoria. También instala integraciones de agentes, mantiene eventos de trabajo útiles, convierte commits en hechos del proyecto, expone un plano de control local y puede coordinar trabajo multiagente cuando una tarea lo necesita.

Capacidad	Qué hace	Punto de entrada
Memory Autopilot	Un Workset de tareas acotado con archivos de inicio, memoria actual, conocimiento respaldado por fuentes, inicios de flujo de trabajo, advertencias y verificación. Los recibos JSON compactos mantienen acotado también el uso de CLI de respaldo.	memorix context "..." --brief-json, memorix resume "..." --brief-json, memorix_project_context
Observation Memory	Hechos buscables, correcciones, gotchas, resúmenes de sesión y notas de implementación con alcance al proyecto Git actual	memorix memory, herramientas de memoria MCP
Curated Long-term Memory	Memoria episódica, semántica y procedimental revisada deliberadamente con evidencia de fuente. Solo un elemento de usuario explícitamente portable puede cruzar proyectos locales	memorix memory long-term
Code State and Code Memory	Instantáneas de código local versionadas, símbolos y relaciones TypeScript/JavaScript respaldados por fuentes, enlaces de archivo/símbolo y comprobaciones de frescura. Otros lenguajes mantienen el respaldo Lite honesto; un CodeGraph local ya indexado o un resultado SCIP puede agregar un esquema externo acotado sin tomar el control del índice local.	memorix codegraph status|refresh|init|sync, actualización automática de contexto
Git Memory	Hechos de ingeniería derivados de commits que responden qué cambió, dónde y por qué importa	memorix ingest commit, hook de git
Reasoning Memory	Racional de diseño, alternativas, compensaciones y riesgos que deberían sobrevivir más allá de un chat	memorix reasoning, formación de memoria
Knowledge Workspace	Afirmaciones respaldadas por fuentes con revisión previa, páginas Markdown y flujos de trabajo canónicos del proyecto; las propuestas nunca sobrescriben páginas revisadas en silencio	memorix knowledge, memorix knowledge workflow
Agent setup	Una única ruta de configuración para MCP, reglas, hooks, habilidades, complementos, bundles o extensiones según el agente	memorix setup --agent <agent>
Agent doctor	Comprueba si la configuración de MCP y las guías del agente están actualizadas y repara las entradas propiedad de Memorix cuando es necesario	memorix doctor agents, memorix repair agents
Hooks and skills	Captura opcional de agentes compatibles, además de habilidades de proyecto reutilizables promovidas desde conocimiento duradero	memorix hooks, memorix skills
Dashboard and HTTP	Una interfaz web local y un endpoint MCP compartido para explorar memoria, estado del proyecto, equipos, diagnósticos y acciones de limpieza, consolidación, deduplicación y retención con vista previa	memorix dashboard, memorix background start
Orchestration and team work	Planificación de tareas, traspasos de trabajadores, bloqueos de archivos, mensajes, puertas de verificación y bucles de revisión	memorix orchestrate, memorix team, memorix lock
memcode	Un agente de codificación de terminal incluido que ya lee y escribe la misma memoria de proyecto	memorix, memcode
CLI and SDK	Acceso mediante scripts para automatización, importaciones/exportaciones, diagnósticos e integraciones personalizadas	memorix ..., createMemoryClient()
Optional multi-device sync	Eventos de observación filtrados por privacidad con SQLite local como canónico; alcance de proyecto predeterminado, --scope user opcional para cada proyecto local; retransmisión GitHub JSONL, sistema de archivos, S3 o Postgres	memorix sync store status|push|pull

Memorix se conecta a través de las interfaces que cada agente ya admite: paquetes de complementos, MCP, reglas de proyecto, hooks, habilidades o el agente de terminal incluido. memorix setup elige la configuración correcta para cada agente y mantiene stdio MCP como transporte predeterminado.

Claude Code complemento oficial + MCP + hooks + habilidades	Codex CLI complemento oficial + MCP + AGENTS.md	GitHub Copilot CLI complemento + MCP + hooks + habilidades	Cursor MCP + reglas + habilidades	Windsurf MCP + reglas + hooks	Gemini CLI extensión + MCP + hooks + habilidades
OpenCode complemento local + MCP + habilidades + AGENTS.md	pi coding agent paquete + extensión + habilidad	Kiro MCP + dirección + hooks	Antigravity complemento + MCP + hooks + habilidades	Trae MCP + reglas de proyecto	memcode agente de terminal incluido
OpenClaw bundle + MCP + hooks + habilidades	Hermes Agent complemento + MCP + hooks + habilidades	Oh-my-Pi paquete + MCP + hooks + habilidades	DeepSeek Harness parche MCP + AGENTS.md + habilidades	Any MCP Client MCP stdio o HTTP	Grok Build hooks nativos + AGENTS.md

_{Funciona con agentes que hablan MCP, exponen hooks/reglas, o admiten entradas de plugins/paquetes. Una capa de memoria local-first compartida entre todos ellos.}

Superficies de integración:

Superficie	Qué hace	Entrada de Memorix
Comando de configuración	Instala la integración recomendada de Memorix a nivel de usuario, única vez	memorix setup --agent <agent> --global
MCP	Da al agente herramientas compactas de Memorix para contexto de proyecto, búsqueda, recuperación de detalles, almacenamiento y resolución	incluido en paquetes de configuración o memorix serve
Guía de uso	Enseña al agente cuándo y cómo usar Memorix sin forzar la consulta de memoria en cada prompt	incluido o generado por memorix setup
Hooks	Captura opcional de prompts, eventos de herramientas, ediciones de archivos, eventos del ciclo de vida de la sesión y puntos de control de compactación nativos donde el agente los expone	incluido o generado por memorix setup
Paquete de plugin o bundle	Instala archivos de plugin, bundle compatible o paquete donde el agente los admita	Claude Code, Codex, CodeBuddy Code, GitHub Copilot CLI, Antigravity, OpenClaw, Hermes Agent, Oh-my-Pi, Pi
Extensión	Instala archivos de extensión donde el agente los admita	Gemini CLI
Plugin local	Instala archivos de plugin local donde el agente los cargue directamente	OpenCode
Config de MCP/reglas	Escribe config de MCP, reglas, dirección, guía o hooks para IDEs y agentes que exponen esas superficies	Cursor, Windsurf, Kiro, Trae, DeepSeek Harness, WorkBuddy
Skills	Convierte conocimiento duradero del proyecto en guía de tareas reutilizable	memorix skills y memorix_promote
memcode	Abre el agente de terminal incluido que ya usa la memoria de Memorix	memorix o memcode

Consulta Superficies de integración para la matriz de soporte actual y qué significa cada archivo generado.

Usa el mismo comando de configuración sin --global solo cuando quieras intencionalmente guía, reglas o hooks locales al repositorio en el proyecto Git actual.

CLI, MCP y HTTP son puntos de entrada diferentes:

• memorix CLI es la superficie de comando directa para configuración, búsqueda/almacenamiento de memoria, Git Memory, importación/exportación, panel, orquestación, diagnósticos y automatización.
• memorix serve es el puente MCP stdio usado por IDEs y agentes de codificación. Su perfil de herramientas predeterminado es micro, por lo que los agentes ven solo el conjunto de herramientas central compacto.
• memorix background start / memorix serve-http ejecutan el servicio HTTP para un endpoint compartido, panel, despliegue Docker en VPS o múltiples clientes.

La sincronización de almacenamiento multi-dispositivo es opcional y separada del compartir HTTP. Nunca sube la base de datos SQLite en vivo ni archivos WAL. Por defecto solo retransmite observaciones calificadas visibles del proyecto para el proyecto Git actual; los registros personales, dirigidos al agente, candidatos y efímeros permanecen locales. Pasa --scope user para incluir cada proyecto local. Establece MEMORIX_SYNC_PROVIDER e inspecciona memorix sync store status --json antes del primer push.

Requisitos:

• Node.js >=22.18.0
• Git, porque la identidad del proyecto se deriva de la raíz Git real

Instala e inicializa:

npm install -g memorix
memorix init --global                   # optional defaults
memorix setup --agent claude --global   # or codex, copilot, cursor, pi, gemini-cli, opencode,
                                       # codebuddy, windsurf, kiro, antigravity, trae, openclaw, hermes, omp

memorix init es opcional. Crea o actualiza la configuración TOML:

• ~/.memorix/config.toml para valores predeterminados globales
• <git-root>/memorix.toml para anulaciones opcionales del proyecto

Los memorix.yml, .env y ~/.memorix/config.json heredados aún se leen por compatibilidad, pero los nuevos flujos de configuración usan TOML.

Si quieres guía o hooks locales al repositorio para un repositorio específico, ejecuta el mismo comando de configuración desde dentro de ese repositorio sin --global. Codex es la excepción: su ruta admitida es la instalación del plugin a nivel de usuario, por lo que Memorix deja la configuración de .codex del proyecto intacta.

Conectar un agente existente

Usa primero el comando de configuración. La forma global es la instalación normal de una sola vez:

memorix setup --agent claude --global
memorix setup --agent codex --global
memorix setup --agent copilot --global
memorix setup --agent cursor --global
memorix setup --agent pi --global
memorix setup --agent gemini-cli --global
memorix setup --agent opencode --global
memorix setup --agent windsurf --global
memorix setup --agent kiro --global
memorix setup --agent antigravity --global
memorix setup --agent trae --global
memorix setup --agent openclaw --global
memorix setup --agent hermes --global
memorix setup --agent codebuddy --global
memorix setup --agent omp --global
memorix setup --agent dsh --global
memorix setup --agent workbuddy --global
memorix setup --agent grok --global

Lo que instala depende del agente objetivo, pero el objetivo es el mismo: hacer que Memorix esté disponible dondequiera que abras ese agente sin pedirte que conectes cada repositorio manualmente.

• Claude Code: instala el paquete de plugin de Memorix, añade la guía CLAUDE.md y habilita la captura de hooks cuando no pasas --noHooks.
• Codex: instala un plugin de Memorix a nivel de usuario con MCP stdio incluido, skills y hooks de ciclo de vida. No escribe config de .codex local al proyecto ni cambia tu modelo, aprobación o configuración de sandbox. Cuando Codex lo pregunte, revisa la definición del hook del plugin una vez con /hooks; --noHooks omite la captura automática.
• GitHub Copilot CLI: instala el paquete de plugin de Copilot y los skills oficiales de Memorix.
• Pi: instala el paquete de Pi a nivel de usuario y los skills oficiales.
• Cursor: escribe entradas de MCP/reglas/config de Cursor en el ámbito elegido.
• Gemini CLI: instala el paquete de extensión, contexto GEMINI.md, hooks y skills. Antigravity CLI tiene una ruta oficial de migración desde Gemini CLI, pero Gemini CLI sigue siendo un objetivo independiente activo.
• OpenCode: instala el archivo de plugin local, opencode.json, skills y guía AGENTS.md.
• Windsurf, Kiro, Trae: escriben los archivos de MCP/reglas/hooks que el objetivo admite.
• Antigravity: instala el paquete de plugin oficial con plugin.json, mcp_config.json, hooks.json, reglas y skills bajo ~/.gemini/config/plugins/memorix o .agents/plugins/memorix.
• OpenClaw: instala un bundle compatible con OpenClaw con .mcp.json, skills oficiales y un paquete de hooks HOOK.md/handler.ts de OpenClaw.
• Hermes Agent: instala en el home de Hermes (%LOCALAPPDATA%\hermes en Windows nativo, ~/.hermes en otros lugares, o HERMES_HOME), habilita el plugin en config.yaml, registra hooks de plugin, comandos slash/CLI, skills y escribe config de MCP.
• CodeBuddy Code: instala un plugin de marketplace local de ámbito de usuario bajo ~/.codebuddy/memorix-local con MCP, skills y hooks. No cambia los archivos existentes de modelo, permisos o configuración de CodeBuddy; CodeBuddy mantiene la aprobación de hooks de terceros en su propio flujo /hooks.
• Oh-my-Pi: instala un paquete omp.extensions con eventos de hook de extensión, un comando memorix, skills oficiales y escribe config de MCP.
• DeepSeek Harness: escribe una fila de Memorix @deepseek-ai/dsh-mcp-client en $DSH_HOME/cordis.patch.yml (predeterminado ~/.dsh/cordis.patch.yml), añade guía al AGENTS.md del harness e instala skills oficiales bajo $DSH_HOME/skills. La fila sigue la referencia de Memorix incluida de DSH, por lo que las herramientas aparecen como mcp__memorix__*.
• WorkBuddy: escribe una fila de servidor MCP de Memorix en ~/.workbuddy/mcp.json (o <project>/.workbuddy/mcp.json para instalaciones de proyecto) y añade guía a AGENTS.md. Las herramientas aparecen como mcp__memorix__*; no hay superficie de hooks.
• Grok Build: instala hooks de ciclo de vida nativos bajo ~/.grok/hooks/memorix.json y guía en ~/.grok/AGENTS.md. MCP permanece propiedad del host por defecto; pasa --mcp http para escribir [mcp_servers.memorix] con url = "http://localhost:3211/mcp". Los hooks locales al proyecto requieren Grok /hooks-trust, mientras que los hooks globales son confiables. Establece GROK_HOME para usar un home de Grok personalizado.

¿Necesitas una instalación más silenciosa? Añade --noHooks para objetivos donde la configuración puede controlar la captura de hooks por separado de la entrada oficial del paquete del host. Mantiene MCP y guía, pero omite la captura de hooks de Memorix.

Si quieres intencionalmente guía o hooks locales al repositorio, ejecuta el mismo comando dentro de ese repositorio sin --global.

Si tu agente solo necesita una entrada MCP manual, usa stdio:

{
  "mcpServers": {
    "memorix": {
      "command": "memorix",
      "args": ["serve"]
    }
  }
}

Para un cliente MCP basado en npm o un probador de registros, usa el comando completo npx -y memorix serve. El argumento serve importa: memorix sin argumentos abre el agente de terminal memcode incluido cuando lo ejecuta un humano, mientras que los clientes MCP deben iniciar el servidor stdio explícitamente.

Para una entrada de Claude Code gestionada manualmente, añade "alwaysLoad": true dentro del objeto de servidor memorix. Esto permite que Claude Code exponga las herramientas de Memorix durante el inicio en modo print; memorix doctor agents --agent claude puede detectar y reparar una configuración faltante.

HTTP no es necesario para la configuración normal. Úsalo solo cuando quieras intencionalmente un servicio de fondo compartido, panel, despliegue Docker en VPS o múltiples clientes usando el mismo endpoint. El desarrollo local usa el servicio Node directamente y no requiere Docker:

memorix background start

Luego apunta el cliente a:

http://localhost:3211/mcp

En modo HTTP, los agentes deben vincular el repositorio activo explícitamente con memorix_session_start(projectRoot=...) cuando el cliente pueda proporcionar la ruta del espacio de trabajo. Git sigue siendo la fuente final de verdad para la identidad del proyecto.

Desinstalar

Vista previa de lo que se eliminará:

memorix uninstall --dry-run

Detén el servicio de fondo y elimina los hooks:

memorix uninstall --background --hooks

Limpieza completa:

memorix uninstall --yes --background --hooks --purge-data
npm uninstall -g memorix

memorix uninstall reporta entradas de config de MCP para limpieza manual en lugar de editar silenciosamente cada archivo MCP que encuentra.

Trabajar desde la CLI

memorix --cwd /path/to/repo resume "continue release blocker"
memorix checkpoint list
memorix memory search --query "release blocker"
memorix memory --help

# Optional: activate one local agent identity for personal/team records and coordination.
memorix identity join --agent-type codex --name codex-main
memorix memory store --text "private investigation note" --visibility personal
memorix task create --description "verify the release package"

# Deliberate durable memory: create a candidate, then review it before it can enter a Workset.
memorix memory long-term add --kind procedural --scope user --portability portable --title "Release verification preference" --text "Run focused tests and a packed-package smoke before publishing." --applicability "When publishing an npm package."
memorix memory long-term qualify --id <id> --reason "The user explicitly confirmed this preference."
memorix memory long-term approve --id <id> --reason "Reviewed for future local projects."

memorix transfer export --format json --out ./.memorix-export.json
memorix transfer import --file ./.memorix-export.json
memorix reasoning search --query "why sqlite"
memorix git-hook --force
memorix ingest log --count 20
memorix workbench

La CLI es directa y no depende de una sesión MCP. Se vincula al proyecto Git actual, o al proyecto proporcionado con --cwd. Sin una identidad activa, solo lee, escribe y exporta memoria visible del proyecto. Usa memorix identity join o memorix identity use --agent-id <id> solo cuando necesites intencionalmente memoria personal/equipo o acciones de tareas coordinadas; memorix identity clear devuelve la terminal al ámbito del proyecto. --as <active-agent-id> es la alternativa de un solo comando para scripts. Se aceptan banderas tanto en camelCase como en kebab-case.

Gestionar medios controlados

Los medios son opcionales. Una importación local explícita se copia al directorio de datos local de Memorix, se hashea y se mantiene fuera del árbol de trabajo Git. Se convierte en memoria normal solo cuando la adjuntas. Memorix nunca captura cada captura de pantalla o salida de herramienta. Un activo puede tener hasta el límite de medios configurado (100 MiB por defecto). El análisis automático de visión está deliberadamente limitado a 20 MiB; una imagen más grande aún se conserva y se puede adjuntar, pero Memorix registra un respaldo de texto claro en lugar de enviar un payload sobredimensionado a un proveedor de modelos.

memorix media import --path ./architecture.png --json
memorix media attach --asset <asset-id> --title "Architecture diagram" --json
memorix media list --kind image --json
memorix media show --asset <asset-id> --json
memorix media remove --asset <asset-id> --force --json

# Controlled derivations: explicit, bounded, and attachable to memory.
memorix media derive-pdf --asset <asset-id> --attach --json
memorix media derive-audio --asset <asset-id> --attach --json

# Legacy image analysis now uses the same controlled asset lifecycle.
memorix ingest image --path ./architecture.png --json

La generación de imágenes MiniMax es una operación CLI deliberada. La generación de video devuelve un trabajo duradero inmediatamente; inspecciona o cancela ese trabajo en lugar de esperar en una solicitud de agente.

# Configure MINIMAX_API_KEY in your user environment or .env, never in Git.
memorix media generate image --prompt "A clean system architecture diagram" --json
# Image-to-image with a reference image (MiniMax image-01 / image-01-live):
memorix media generate image --prompt "Keep the subject, change the background" --image ./reference.png --json
memorix media generate video --prompt "A short product walkthrough" --json
memorix media status --job <media-job-id> --json
memorix media cancel --job <media-job-id> --json

memorix_media es el compañero MCP compacto en cada perfil, incluido micro. Admite importación, adjuntar, listar, mostrar, derivaciones PDF/audio, generación y estado de trabajos. La generación de imágenes y video MCP está deshabilitada por defecto porque puede incurrir en costos de proveedor. Establece MEMORIX_MCP_MEDIA_GENERATION=1 solo después de que deliberadamente quieras que un agente solicite salida MiniMax facturada. La vía normal de embeddings de texto OpenRouter sigue siendo solo texto; los vectores de medios se crean solo por un proveedor que declare explícitamente soporte para esa modalidad. Las descripciones de texto y los adjuntos siguen siendo un respaldo útil de recuperación ordinaria.

Usar el agente de terminal incluido

memorix
# or
memcode

Esto abre memcode, un agente de codificación de terminal que usa la misma memoria de proyecto de Memorix que tus agentes conectados por MCP.

Capa	Almacena	Mejor para
Memoria de Observación	hechos, trampas, correcciones, notas de implementación	"¿Cómo funciona esto?"
Memoria de Razonamiento	justificación, alternativas, restricciones, riesgos	"¿Por qué elegimos esto?"
Git Memory	hechos de ingeniería derivados de commits	"¿Qué cambió y dónde?"
Memoria de Código	archivos, símbolos, bordes de importación y frescura memoria-código	"¿Qué código actual debería inspeccionar primero?"
Memoria a Largo Plazo Curada	eventos episódicos revisados, hechos estables o procedimientos reutilizables con evidencia	"¿Qué debería saber o hacer este agente más adelante?"
Continuidad Compacta	resúmenes compactos recientes del host o marcadores de ciclo de vida	"¿Qué sobrevivió a la última compactación de contexto?"

La búsqueda está limitada al proyecto por defecto. scope="global" busca entre proyectos. La búsqueda impulsa Git Memory para preguntas de "qué cambió" y registros de razonamiento para preguntas de "por qué". La memoria a largo plazo no es deliberadamente un volcado automático de cada nota. Una observación fuente, Claim, flujo de trabajo, sesión y captura de código mantienen sus roles existentes. Un agente puede solicitar memorix_store para crear un registro adicional a largo plazo; una solicitud explícita califica automáticamente y entra en los briefs de tareas como un ancla duradera, mientras que los candidatos capturados por hooks o derivados de Git permanecen pendientes hasta que se califiquen. La aprobación sigue siendo una revisión explícita del operador. Use memorix memory long-term approve|archive|supersede para registrar el ciclo de vida respaldado por evidencia. Solo un elemento user + portable creado manualmente o confirmado por el usuario puede considerarse en otro proyecto local; el código del proyecto, los hechos de Git, las pruebas, los flujos de trabajo, las sesiones y las observaciones no pueden promoverse a la memoria portátil del usuario.

memorix context "..." es la entrada predeterminada del Memory Autopilot. Construye un brief compacto con lente de tarea para agentes: las tareas de corrección de errores se inclinan hacia pruebas y reproducciones, las tareas de lanzamiento se inclinan hacia verificaciones de paquetes/changelog/compilación, las tareas de incorporación se inclinan hacia documentación y puntos de entrada, y los recuerdos obsoletos o no relacionados permanecen en carriles de advertencia en lugar de inundar el prompt. Use --fallback --brief-json cuando MCP no esté disponible y un fallback CLI necesite el mismo brief limitado más un recibo de lo seleccionado u omitido; --json sigue siendo la forma de diagnóstico detallada. Una tarea nueva normal no recibe un volcado de sesión antigua. Para una continuación explícita, memorix resume "..." agrega solo el resumen de sesión útil más reciente, hasta tres anclas duraderas legibles y como máximo un checkpoint compacto reciente del host etiquetado por fuente. Una ancla duradera lleva una referencia durable:<id>, por lo que un agente puede expandir el registro completo revisado a través de memorix_detail solo cuando sea necesario. Las coincidencias de palabras clave siguen siendo primarias; cuando ningún elemento duradero revisado coincide y hay un proveedor de embeddings configurado, Memorix realiza un fallback semántico de 1.8 segundos sin reintentos para paráfrasis o tareas entre idiomas. Un proveedor lento o no disponible simplemente deja intacto el Workset normal solo de palabras clave. Un checkpoint es evidencia del ciclo de vida, no memoria duradera ni respaldo de transcripción. Los agentes deben leer los archivos sugeridos antes de confiar en la memoria almacenada.

Quieres	Ejecuta
Instalar un paquete de integración de agente	memorix setup --agent <agent> --global
Verificar o reparar una integración de agente	memorix doctor agents --agent <agent>, memorix repair agents --agent <agent>
Exponer manualmente MCP stdio	memorix serve
Ejecutar MCP HTTP compartido más panel	memorix background start
Depurar MCP HTTP en primer plano	memorix serve-http --port 3211
Inspeccionar o gestionar memoria directamente	memorix memory, memorix reasoning, memorix session, memorix ingest, memorix media
Gestionar memoria a largo plazo revisada	`memorix memory long-term list
Retirar recuerdos de la recuperación	memorix purge (proyecto actual), memorix purge --all --yes (todo)
Inspeccionar la continuidad de compactación nativa	`memorix checkpoint list
Usar el plano de control de memoria de terminal interactivo	memorix workbench
Usar el agente de terminal incluido	memorix o memcode
Ejecutar trabajo de subagente orquestado	memorix orchestrate --goal "..."

memorix serve tiene como valor predeterminado --mode micro (9 herramientas) para mantener los esquemas de herramientas MCP pequeños para agentes. memorix setup escribe --mode lite (21 herramientas) en la configuración MCP instalada para que la superficie normal de memoria, continuidad y sesión sea alcanzable. Use --mode team (29 herramientas) para herramientas de coordinación, o --mode full (48 herramientas) para herramientas avanzadas y de compatibilidad como la inspección de checkpoints.

Atajos y alias: memorix search / remember / recent son atajos de consulta directa, bg/bs inician el servicio en segundo plano, hook ejecuta el lanzador de hooks, y memorix config get|path|migrate inspecciona o migra archivos de configuración.

memorix orchestrate usa el checkout actual para ejecuciones de un solo worker. Al ejecutar múltiples workers, crea worktrees de tarea bajo .worktrees/ y fusiona las ramas de tarea exitosas de vuelta. Use --isolated para forzar el aislamiento de worktree para un worker, --no-worktree para deshabilitarlo, --allow-dirty para ejecutar con cambios sin commitear, y --no-auto-merge para preservar los worktrees de tarea para revisión manual.

memcode es el agente de codificación de terminal incluido con Memorix. Puede leer, editar, ejecutar comandos, reanudar sesiones, cambiar modelos y usar comandos /memory — todo respaldado por la misma memoria de proyecto que tus agentes conectados a MCP.

Úsalo cuando quieras un agente de terminal con memoria ya integrada.

one Git project -> one shared Memorix memory pool

Consulta docs/MEMCODE.md para la guía específica de memcode.

~/.memorix/config.toml mínimo:

[agent]
provider = "openai"
model = "gpt-4o"
api_key = "..."

[memory.llm]
provider = "openai"
model = "gpt-4o-mini"
api_key = "..."

[embedding]
provider = "auto"

[memory]
inject = "minimal"
formation = "active"

Usa [memory.llm] y [embedding] para la calidad y recuperación de memoria de Memorix. Usa [agent] para el modelo con el que memcode habla mientras codifica. Mantén las credenciales en la configuración global o variables de entorno, y no hagas commit de secretos.

Para el preset opcional de memoria Atlas Cloud, ejecuta memorix init y elige Atlas Cloud, o establece provider = "atlascloud" en [memory.llm]. Usa el endpoint compatible con OpenAI https://api.atlascloud.ai/v1 y lee ATLASCLOUD_API_KEY o el MEMORIX_LLM_API_KEY explícito.

Para embeddings de OpenRouter, usa provider = "api", base_url = "https://openrouter.ai/api/v1" y model = "qwen/qwen3-embedding-8b". Memorix acepta OPENROUTER_API_KEY para ese endpoint de embeddings; MEMORIX_EMBEDDING_API_KEY sigue siendo la anulación explícita.

Para generación controlada de medios MiniMax, establece MINIMAX_API_KEY (global) o MINIMAX_CN_API_KEY (región China) en tu entorno o .env. La biblioteca de medios nunca almacena esa clave, una URL de salida firmada o cargas útiles base64. La generación CLI es explícita; la generación MCP además requiere MEMORIX_MCP_MEDIA_GENERATION=1.

Docker es una opción de despliegue HTTP en VPS/hosted, no un requisito para desarrollo local o MCP stdio:

docker compose up --build -d

Luego abre:

• panel: http://localhost:3211
• MCP: http://localhost:3211/mcp
• salud: http://localhost:3211/health

El contenedor debe poder acceder a la ruta del repositorio pasada como projectRoot para el comportamiento de Git y configuración a nivel de proyecto.

Usa Memorix directamente desde TypeScript:

import { createMemoryClient } from 'memorix/sdk';

const client = await createMemoryClient({ projectRoot: '/path/to/repo' });

await client.store({
  entityName: 'auth-module',
  type: 'decision',
  title: 'Use JWT for API auth',
  narrative: 'Chose JWT because the API is stateless and used by multiple clients.',
});

const results = await client.search({ query: 'auth decision' });
await client.close();

Empieza aquí	Úsalo cuando
Mapa de Documentación	Quieras la ruta más corta a la guía correcta
Guía de Configuración	Instalar, usar memorix setup, elegir stdio vs HTTP
Superficies de Integración	Paquetes de plugins, MCP, reglas de proyecto, hooks y soporte de habilidades
Configuración	Configuración TOML, carriles de modelos, archivos de compatibilidad
Referencia de API	Herramientas MCP y comandos CLI
Memoria Git	Ingesta de commits y verdad de ingeniería buscable
Docker	Servicio HTTP contenerizado
memcode	Usar el agente de terminal incluido
Playbook de Agente	Guía de ejecución orientada a IA para instalación, vinculación, hooks y solución de problemas
Desarrollo	Contribuir, probar, verificaciones de lanzamiento
Changelog	Qué cambió en cada lanzamiento

Resúmenes amigables para LLM: llms.txt y llms-full.txt.

git clone https://github.com/AVIDS2/memorix.git
cd memorix
npm install
npm run lint
npm test
npm run build

Comunidad

Integraciones de escritorio y shell construidas sobre Memorix:

• omarchy-memorix — un widget nativo de barra de shell Omarchy: estadísticas del pool, búsqueda global en vivo, desglose por proyecto, recuerdos recientes y un lanzador de workbench. Solo lectura sobre ~/.memorix/data; sin daemons, sin telemetría.

¿Construiste algo sobre Memorix? Abre un PR para listarlo aquí.

Memorix se inspira en el ecosistema MCP y proyectos de memoria anteriores como mcp-memory-service, MemCP, claude-mem y Mem0. memcode se basa en el código base del agente de codificación Pi y adapta su modelo de agente de terminal para el ecosistema Memorix.

Apache 2.0

Historial de Estrellas

_{Actualizado automáticamente desde la API de historial de estrellas de GitHub, segura para privacidad. Sin PRs generados.}