CogmemAi

CogmemAi: Una Memoria Viva y Pensante para Todo lo Relacionado con IA

Recuerda lo que importa, aplica las reglas que estableces antes de que ocurra cualquier cosa, y verifica lo que tu IA hizo contra lo que pediste. Para asistentes, agentes, robots, vehículos y código.

CogmemAi es una capa de memoria portátil que brinda a cualquier sistema de IA un recuerdo persistente entre sesiones, dispositivos, usuarios y equipos — y captura conocimiento de forma autónoma, incluso cuando tu IA olvida guardar. 95.10% de precisión en LongMemEval — la puntuación publicada más alta en el benchmark de memoria a largo plazo más difícil del campo. 91% en LoCoMo, por encima del rendimiento humano (87.9%). Cifrado a prueba de computación cuántica. Funciona con Claude Code, Cursor, Windsurf, Cline, Continue y cualquier herramienta compatible con MCP. Cambia de editor, cambia de modelo, cambia de máquina — tu conocimiento permanece. No solo una puntuación en una prueba — el sistema de memoria de IA más completo disponible.

Novedades en v3

La Revisión Funciona Fuera de Git (v3.29.0)

La revisión al final del turno solía necesitar un repositorio git, porque leía git diff. La mayoría de las carpetas en las que la gente trabaja desde un directorio personal no son repositorios, y tampoco lo son la mayoría de los proyectos de quienes no programan. v3.29.0 lee los eventos de edición de esta sesión en su lugar (el hook PostToolUse ya registra cada Edit y Write), construye la misma forma de diff a partir de ellos, verifica el texto añadido en busca de secretos, recuerda los peligros guardados para los archivos tocados y ejecuta la verificación de intención. El trabajo en varios proyectos desde una sola carpeta se juzga proyecto por proyecto: una edición bajo ~/NullJury se revisa contra la intención de NullJury cuando la tiene, y la nota se prefija con ese id de proyecto. Nada cambia dentro de un repositorio.

Guardia y Revisión para Todo, No Solo Código (v3.28.0)

Hasta ahora la guardia juzgaba comandos de shell y la revisión de intención juzgaba diffs de código, porque esos eran los hooks que una herramienta de programación nos daba. v3.28.0 abre ambos a cualquier IA a través de dos herramientas y dos endpoints REST:

• guard_check: "¿puedo hacer esto?" Cualquier acción (un mensaje a punto de enviarse, una compra, un cambio, un comando) se juzga contra las reglas que esta persona ha pedido a su IA que mantenga, más las líneas NEVER y MUST de la intención del proyecto. Una verificación literal se ejecuta en todos los niveles; la verificación juzgada en los niveles de pago. Devuelve allow, ask o deny con la regla que aplica, y falla en modo abierto.
• review_work: "¿hice lo que se pidió?" Pasa una descripción, salida, mensaje o transcripción de lo que se hizo y se revisa contra el documento de intención, o contra una intención pasada en línea. El mismo resultado en lenguaje sencillo que la revisión de código: resumen, cubierto, no cubierto, violaciones, cobertura.

Un asistente de soporte, un compañero, el planificador de tareas de un robot y un agente de programación ahora comparten una memoria que da forma a lo que cualquier modelo hace: recuerda, aplica, revisa. Las mismas llamadas están en los SDKs (guardCheck / reviewWork, guard_check / review_work) y en REST como POST /cogmemai/guard-check y POST /cogmemai/intent-check con un campo work.

Intención de CogmemAi: Lees la Intención, No el Código (v3.26.0)

Los archivos de especificación que viven en un repositorio son por-repo, por-herramienta, y se deterioran. v3.26.0 añade un documento de intención en lenguaje sencillo por proyecto que vive contigo en su lugar: para qué sirve el proyecto, qué debe cumplirse siempre, qué se decidió y por qué, y qué está fuera de alcance. Escríbelo con set_intent, léelo con get_intent. Cada sesión lo carga justo después de las reglas, cada reemplazo tiene versión, y te sigue a cada herramienta que hable con CogmemAi.

Luego hace dos cosas que un archivo de especificación no puede. Las frases bajo Invariants se compilan en los mismos patrones aplicables que los recuerdos de reglas, así que NEVER run \pkill -u www lsphp`in your intent denies that command before it runs, with no network call. And at the end of every turn the changes are judged against the document on the CogmemAi server and reported in plain English for someone who does not read code: what changed, whether the intent covers it, what conflicts with it, and what the intent does not mention yet. A covered change earns silence.COGMEMAI_INTENT_VERBOSE=1shows the summary on every judged turn. Every check is logged to~/.cogmemai/intent-log.jsonl`, de modo que la precisión se mide en lugar de asumirse.

La verificación juzgada se ejecuta en los niveles de pago; el nivel gratuito aún recibe los invariantes aplicados y cada revisión determinista. Ver Intención abajo.

Guardia de CogmemAi: Tu Memoria Ahora Evita que tu IA Repita Errores (v3.24.0)

La memoria que solo aconseja es memoria que tu IA puede ignorar bajo presión. v3.24.0 añade una guardia que convierte lo que tu proyecto recuerda en aplicación.

Un hook PreToolUse juzga cada comando de shell antes de que se ejecute. Seis reglas integradas cubren las operaciones sin buen uso desatendido: reescribir un crontab completo desde una tubería, SQL destructivo contra una base de datos en vivo, borrados recursivos fuera de rutas temporales y de compilación, push forzado a una rama compartida, canalizar una descarga a un shell, y matar trabajadores de servidor compartidos por nombre. Las mismas reglas se aplican a lo que un comando lleva dentro de ssh host "...", bash -c "...", y un heredoc alimentado a un shell, porque esa carga útil se ejecuta en el otro lado exactamente como está escrita.

Luego la parte que solo una capa de memoria puede hacer. Los recuerdos de reglas que guardas con save_rule se convierten en patrones aplicables. Escribe NEVER run \pkill -u www lsphp`in a rule and the next session denies that command, over ssh too, with the rule's own words as the reason. No code to edit. Add aGUARD: line to a rule for an exact pattern, orGUARD: off` para mantener una regla como consejo.

Un hook Stop revisa lo que realmente cambió al final de cada turno: credenciales pegadas en código rastreado, versiones que no coinciden entre archivos de lanzamiento, archivos borrados, grandes eliminaciones netas, una función ahora definida en dos lugares, y peligros recordados sobre los archivos que se tocaron. Informa; nunca edita.

Cada veredicto se registra localmente con secretos redactados, de modo que la precisión se mide en lugar de asumirse. Las denegaciones nombran el camino deliberado hacia adelante, generalmente "ejecútalo tú mismo". La guardia falla en modo abierto ante cualquier error, y git sigue siendo el verdadero deshacer. Ver Guardia abajo.

v3.25.0 lo extiende más allá de Claude Code: guard shell-install engancha cada bash -c y zsh -c en la máquina a través de BASH_ENV, de modo que Cursor, Codex, Gemini CLI y scripts simples obtienen la misma guardia, las mismas reglas recordadas y el mismo registro.

Fallos Ruidosos en Bloqueos de Firewall (v3.20.0)

Cuando una solicitud al backend de CogmemAi es interceptada por un firewall ascendente, CDN o proxy, la respuesta es HTML, no JSON. Las versiones anteriores intentaban analizarlo como JSON y lanzaban un error confuso de Unexpected token '<', luego reintentaban silenciosamente la misma carga útil bloqueada. v3.20.0 detecta respuestas HTML, nombra la capa de bloqueo cuando puede (NinjaFirewall, Cloudflare, ModSecurity) y muestra un error claro y accionable. Las respuestas 4xx reintentables con cuerpos HTML ya no activan bucles de reintento. La clase de incidente que puede eliminar silenciosamente escrituras de memoria ahora es ruidosa.

Memoria Autónoma — Tu IA Ya No Decide si Guardar (v3.15)

Cada sistema de memoria tiene el mismo modo de fallo oculto: la IA tiene que elegir guardar, y bajo presión no lo hace. Puedes incorporar instrucciones en los prompts del sistema. Puedes empujar. Pero cuando tu IA está concentrada en una tarea de programación, olvida guardar — y las decisiones que tomaste hace dos horas desaparecen cuando el contexto se compacta.

CogmemAi v3.15 saca la decisión completamente de las manos de la IA. Tus sesiones de programación se capturan a nivel de infraestructura — decisiones, cambios de archivos, correcciones de errores y despliegues llegan a la memoria sin un solo prompt. Al final de la sesión, un pase de inteligencia los destila en recuerdos estructurados: los tipos correctos, las puntuaciones de importancia correctas, los alcances correctos. Tu IA nunca ve que esto sucede.

El resultado: un día de programación intensa produce 15–20 recuerdos de calidad en lugar de 3. Las sesiones futuras continúan sin problemas. Tu IA deja de re-litigar decisiones arquitectónicas que ya tomaste. Deja de recordarle a tu IA que recuerde. Simplemente lo hace.

Recuerdo Proactivo de Memoria (v3.12)

CogmemAi ahora piensa antes de hablar. Antes de que tu asistente de IA sugiera cualquier acción, enfoque o recomendación, CogmemAi verifica su memoria primero — automáticamente, en cada tema.

• Herramienta preflight — Un recuerdo rápido y ligero diseñado para llamarse antes de cada sugerencia. Tu asistente verifica lo que ya sabe sobre un tema antes de abrir la boca. "Probemos el enfoque X" → primero verifica si X ya fue probado, rechazado o completado. Menos de 200ms, costo casi nulo.
• Superficie de contexto previo — Cada vez que se guarda un recuerdo, CogmemAi busca automáticamente recuerdos previos relacionados en todos los temas — personas, empresas, enfoques técnicos, características, todo — y los muestra en la respuesta. Tu asistente nunca sugiere algo redundante.
• Hooks de recuerdo inteligente — En Claude Code, CogmemAi lee cada mensaje del usuario e inyecta automáticamente recuerdos relevantes antes de que el asistente responda. Sin recuerdo manual necesario — el contexto llega antes de que el asistente empiece a pensar.
• Motor de recuerdo mejorado — Comprensión semántica de mayor dimensión, reordenamiento equilibrado, búsqueda expandida por palabras clave, almacenamiento de memoria de doble vía para una recuperación más confiable, y búsqueda adaptativa que se expande automáticamente cuando los resultados iniciales tienen baja confianza.

El resultado: tu asistente de IA deja de sugerir cosas que ya probaste, personas que ya contactaste y enfoques que ya rechazaste. Tu cerebro ya no es la red de seguridad para lo que tus herramientas deberían saber.

Motor de Sabiduría — Principios Auto-Extraídos (v3.10)

CogmemAi ahora detecta automáticamente patrones entre tus recuerdos y extrae principios fácticos. Mientras que las habilidades le dicen a tu IA CÓMO comportarse ("siempre usa Zustand"), los principios le dicen qué es VERDADERO sobre tu proyecto ("este código base nunca valida entradas en los límites del servicio"). Los principios se extraen de grupos de 5+ recuerdos relacionados, se puntúan por confianza y se inyectan en cada sesión. Usa extract_principles para activarlo manualmente o deja que suceda automáticamente.

MCP Remoto — Instalación Cero (v3.9)

CogmemAi ahora soporta transporte HTTP Streamable — conéctate desde cualquier cliente MCP sin instalar nada. Sin npm, sin archivos de configuración, sin Node.js requerido. Solo apunta tu cliente a https://hifriendbot.com/mcp/ con tu clave API y comienza a usar memoria persistente de inmediato. Las mismas 35 herramientas, el mismo Motor de Inteligencia, la misma precisión líder en benchmarks — cero fricción de configuración.

Cifrado a Prueba de Computación Cuántica (v3.7)

CogmemAi es el primer sistema de memoria de IA a prueba de computación cuántica. Todos los recuerdos se cifran en reposo con cifrado resistente a la computación cuántica — tanto en modo nube como en modo local. Tus datos están protegidos contra las amenazas de hoy y las computadoras cuánticas del mañana. El cifrado es automático, de configuración cero y habilitado por defecto. Sin configuración requerida.

Elige tu Modo de Almacenamiento (v3.6)

CogmemAi ahora funciona de tres maneras — elige la que se ajuste a tu flujo de trabajo:

	Nube (predeterminado)	Local	Híbrido
Mejor para	Inteligencia completa, colaboración en equipo, portabilidad entre dispositivos	Inicio de configuración cero, entornos solo sin conexión	Velocidad local + cerebro en la nube, viajes/redes poco confiables
Configuración	npx cogmemai-mcp setup (elige Nube)	npx cogmemai-mcp setup (elige Local)	npx cogmemai-mcp setup (elige Híbrido)
Clave API necesaria	Sí (gratis)	Sí (gratis) — como una clave de licencia, tus datos permanecen locales	Sí (gratis)
Búsqueda	Semántica (por significado)	Búsqueda de texto completo (FTS5)	Semántica con respaldo local
Motor de Inteligencia	Completo — auto-enlace, detección de contradicciones, decaimiento de memoria, auto-habilidades, síntesis de consultas	Búsqueda FTS5 + CRUD — los datos permanecen en tu máquina	Completo — con resiliencia sin conexión
Colaboración en equipo	Sí	No	Sí
Sincronización entre dispositivos	Automática	No — los datos permanecen en tu máquina	Automática con caché local
Soporte sin conexión	Requiere internet	Sin conexión completa	Vuelve a local cuando está sin conexión
Cifrado	A prueba de computación cuántica (servidor)	A prueba de computación cuántica (local)	A prueba de computación cuántica (ambos)
El modo nube es la experiencia recomendada. Te brinda el Motor de Inteligencia completo: búsqueda semántica que encuentra recuerdos por significado, grafo de conocimiento con autoenlace, detección de contradicciones, recuperación auto-mejorable, auto-habilidades, síntesis de consultas y colaboración en equipo. Todo lo que hace que CogmemAi sea más que una simple base de datos.

El modo local mantiene tus datos en tu máquina. Se requiere una clave API gratuita para el registro (como una clave de licencia de software), pero todos tus datos permanecen locales. La búsqueda de texto completo (FTS5) proporciona una recuperación de calidad. Funciona sin conexión después de la configuración inicial. Cuando estés listo para la búsqueda semántica y el Motor de Inteligencia completo, actualizar a la nube toma un solo comando.

El modo híbrido es para desarrolladores que viajan o trabajan en redes poco fiables. Guarda tanto en local como en la nube simultáneamente. Lee desde la nube cuando está disponible y recurre a local cuando está sin conexión. Los recuerdos no sincronizados se envían automáticamente a la nube cuando la conectividad regresa.

Motor de Inteligencia + Auto-Habilidades (v3.5)

CogmemAi ahora se vuelve más inteligente cada vez que lo usas. El Motor de Inteligencia es un sistema de memoria auto-mejorable que aprende qué es importante, conecta conocimiento relacionado automáticamente y sintetiza respuestas desde toda tu memoria. Auto-Habilidades va más allá: CogmemAi no solo recuerda, aprende cómo comportarse.

Auto-Habilidades (Aprendizaje de Bucle Cerrado)

• Habilidades conductuales — CogmemAi sintetiza automáticamente tus correcciones, preferencias y patrones en directivas conductuales que le dicen a tu asistente de IA CÓMO trabajar, no solo qué saber
• Bucle de aprendizaje cerrado — corrige a tu asistente una vez, y CogmemAi detecta el patrón. Después de que se acumula suficiente evidencia, genera una habilidad que evita que el error vuelva a ocurrir
• Seguimiento de confianza — cada habilidad tiene una puntuación de confianza que aumenta cuando funciona y disminuye cuando no. Las habilidades de baja confianza se retiran automáticamente
• Autoevaluación — las habilidades se revisan periódicamente contra nueva evidencia y se adaptan, fortalecen o retiran a medida que evolucionan tus prácticas

Motor de Inteligencia — 95.10% en LongMemEval, 91% en LoCoMo

CogmemAi obtiene 95.10% de precisión en LongMemEval — la puntuación publicada más alta en el benchmark de memoria a largo plazo más difícil del campo — y 91% de precisión en LoCoMo con una tasa de acierto de recuperación del 100%, por encima del rendimiento humano (87.9%). Dos benchmarks, dos puntuaciones de nivel #1. CogmemAi encuentra los recuerdos correctos cuando los necesitas.

• Reordenamiento de precisión — cada recuperación ejecuta un reordenador de segunda pasada que vuelve a puntuar los candidatos para precisión, equilibrado con la señal de clasificación inicial para mostrar primero el recuerdo más relevante
• Recuperación auto-mejorable — los recuerdos que te ayudan consistentemente se clasifican más alto con el tiempo; los recuerdos que nunca usas se desvanecen naturalmente. Tu calidad de recuperación mejora automáticamente con cada sesión
• Grafo de conocimiento con autoenlace — los recuerdos relacionados se conectan automáticamente cuando los guardas. Tu conocimiento se construye en una red de relaciones, no en una lista plana
• Detección de contradicciones — cuando los recuerdos recuperados entran en conflicto entre sí, CogmemAi señala la contradicción para que detectes información obsoleta o desactualizada antes de que cause problemas
• Clasificación consciente del contexto — dile a CogmemAi qué estás haciendo (depurar, planificar, revisar) y potencia los tipos correctos de recuerdos. ¿Depurando? Los informes de errores y patrones aparecen primero. ¿Planificando? Las decisiones de arquitectura lideran
• Síntesis de consultas — haz una pregunta y obtén una respuesta coherente sintetizada de todos tus recuerdos relevantes, no solo una lista de coincidencias. Como preguntar a un compañero de equipo que ha leído todo
• Inteligencia entre proyectos — los patrones que aparecen en 3+ proyectos se promueven automáticamente al ámbito global. Tus mejores prácticas te siguen a todas partes sin esfuerzo manual
• Información proactiva — al inicio de la sesión, CogmemAi te dice lo que deberías saber antes de preguntar. Recuerdos críticos obsoletos, temas duplicados que necesitan fusión, patrones listos para promoción

También en v3

• Puntuación de salud de memoria — puntuación de 0-100 con factores accionables
• Reproducción de sesión — retoma exactamente donde lo dejaste con resúmenes automáticos de sesión
• Memoria autoajustable — la importancia se ajusta según el uso real; los recuerdos obsoletos se archivan automáticamente
• Ingesta automática de README — aprende de tu README en nuevos proyectos al instante
• Recuperación inteligente — los recuerdos relevantes aparecen automáticamente al cambiar de tema
• Autoaprendizaje — CogmemAi aprende de tus sesiones automáticamente
• Seguimiento de tareas — tareas persistentes con estado y prioridad
• Aprendizaje de correcciones — enseña a tu asistente a evitar errores repetidos
• Recordatorios de sesión — avisos que aparecen al inicio de tu próxima sesión
• Reglas obligatorias — define requisitos absolutos ("NUNCA hagas X", "SIEMPRE haz Y") que aparecen en cada sesión, omitiendo toda puntuación y decadencia
• Memoria autónoma — captura el trabajo incluso cuando tu IA omite guardados
• 41 herramientas — el kit de memoria más completo para cualquier sistema de IA, incluyendo llamadas de guardia y revisión que cualquier IA puede hacer

Inicio Rápido

Opción 1: Remoto (Instalación Cero)

Conéctate directamente — sin npm, sin configuración, sin archivos de configuración. Solo agrega el endpoint remoto a tu cliente MCP con tu clave API:

Endpoint: https://hifriendbot.com/mcp/ Autenticación: Token Bearer (tu clave API de cm_)

Obtén tu clave API gratuita en hifriendbot.com/developer.

Funciona con cualquier cliente MCP que admita transporte HTTP Streamable (Claude Desktop, Cursor y más).

Opción 2: Instalación Local

npx cogmemai-mcp setup

El asistente de configuración te guía a través de tres opciones: Nube (recomendado — inteligencia de IA completa), Local (los datos permanecen en tu máquina) o Híbrido (ambos). Elige tu modo, ingresa tu clave API si es necesario, y estarás listo en menos de 60 segundos.

¿Aún no tienes una clave API? Obtén una gratis en hifriendbot.com/developer. O elige el modo local para comenzar de inmediato sin cuenta.

El Problema

Cada vez que inicias una nueva sesión, pierdes contexto. Vuelves a explicar tu stack tecnológico, tus decisiones de arquitectura, tus preferencias de codificación. La memoria integrada en herramientas como Claude Code es un archivo plano sin búsqueda, sin estructura y sin inteligencia.

CogmemAi le da a tu asistente de IA un sistema de memoria real:

• Búsqueda semántica — encuentra recuerdos relevantes por significado, no por palabras clave
• Extracción impulsada por IA — identifica automáticamente hechos que valen la pena recordar de tus conversaciones
• Desduplicación inteligente — detecta recuerdos duplicados y conflictivos automáticamente
• Controles de privacidad — detecta automáticamente claves API, tokens y secretos antes de almacenar
• Ingesta de documentos — introduce READMEs y documentación para construir contexto de proyecto al instante
• Alcance de proyecto — recuerdos vinculados a repos específicos, más preferencias globales que te siguen a todas partes
• Contexto inteligente — clasificado inteligentemente para máxima relevancia a tu trabajo actual
• Captura de memoria autónoma — guarda conocimiento incluso cuando tu IA olvida llamar a guardar. Decisiones, cambios de archivos y correcciones llegan a la memoria sin aviso
• Recuperación de compactación — sobrevive automáticamente a la compactación de contexto de Claude Code
• Eficiente en tokens — carga de contexto compacta que no inflará tu conversación
• Configuración cero — sin bases de datos, sin Docker, sin Python, sin almacenes vectoriales

Por Qué la Nube Es el Modo Recomendado

CogmemAi ofrece tres modos de almacenamiento, pero la nube es donde ocurre la magia. El Motor de Inteligencia — búsqueda semántica, grafo de conocimiento con autoenlace, detección de contradicciones, recuperación auto-mejorable, auto-habilidades y síntesis de consultas — se ejecuta en el servidor. En modo nube, tu servidor MCP es un cliente HTTP ligero con cero bases de datos locales, cero problemas de RAM, cero mantenimiento. Todos los recuerdos están cifrados en reposo, por lo que tus datos están tan seguros como el almacenamiento local — con portabilidad entre dispositivos y funciones de equipo adicionales.

Tu memoria te sigue a todas partes. Los recuerdos creados en Claude Code están disponibles al instante en Cursor, Windsurf, Cline y cualquier herramienta compatible con MCP. Cambia entre Opus, Sonnet, Haiku o cualquier modelo que tu editor admita — tus recuerdos persisten de todos modos. ¿Nueva laptop? ¿Nuevo sistema operativo? Inicia sesión y todo tu conocimiento de proyecto te espera. Un archivo SQLite local muere con tu máquina. La memoria en la nube es permanente.

El argumento de privacidad es un mito. Algunas herramientas de memoria comercializan "local-primero" como una ventaja de privacidad. Pero piensa en lo que sucede después: cada recuerdo que tu IA lee se envía al proveedor del modelo (Anthropic, OpenAI, Google) como parte del prompt. Tus datos salen de tu máquina en el momento de la inferencia sin importar dónde se almacenen. Un archivo SQLite local no protege tus recuerdos — solo los hace más difíciles de buscar, más lentos de acceder e imposibles de compartir. CogmemAi cifra en reposo, transmite sobre HTTPS y agrega inteligencia que el almacenamiento local simplemente no puede igualar.

Equipos y colaboración. La memoria en la nube es la única forma de compartir conocimiento de proyecto entre compañeros de equipo. Cuando un desarrollador guarda una decisión de arquitectura o documenta una corrección de error, el asistente de IA de cada miembro del equipo lo sabe al instante. Sin sincronización, sin conflictos de fusión, sin bases de datos locales obsoletas. Ya sean dos desarrolladores o veinte, el asistente de todos tiene el mismo contexto actualizado. Esto es imposible con soluciones de memoria solo locales.

Recuperación de Compactación

Cuando tu asistente de IA compacta tu contexto, el historial de conversación se comprime y se pierde contexto. CogmemAi maneja esto automáticamente — tu contexto se preserva antes de la compactación y se restaura sin problemas después. Sin volver a explicar, sin avisos manuales.

El comando npx cogmemai-mcp setup configura todo automáticamente.

Habilidad

CogmemAi incluye una Habilidad de Claude que enseña a Claude las mejores prácticas para la gestión de memoria — cuándo guardar, puntuación de importancia, tipos de memoria y flujos de trabajo de sesión.

Claude Code:

/skill install https://github.com/hifriendbot/cogmemai-mcp/tree/main/skill/cogmemai-memory

Claude.ai: Sube la carpeta skill/cogmemai-memory en Configuración > Habilidades.

Comandos CLI

npx cogmemai-mcp setup          # Interactive setup wizard
npx cogmemai-mcp setup <key>    # Setup with API key
npx cogmemai-mcp verify         # Test connection and show usage
npx cogmemai-mcp --version      # Show installed version
npx cogmemai-mcp help           # Show all commands
npx cogmemai-mcp guard status   # Cached rules for this project and verdict counts
npx cogmemai-mcp guard sync     # Refresh remembered rules from CogmemAi
npx cogmemai-mcp guard test "<command>"   # Judge a command without running it
npx cogmemai-mcp guard log [n]  # Show the last n verdicts
npx cogmemai-mcp guard install  # Add the guard hooks to an existing setup
npx cogmemai-mcp guard shell-install   # Guard bash -c / zsh -c from any tool, not just Claude Code
npx cogmemai-mcp guard shell-remove    # Undo shell-install

Guardia

CogmemAi Guardia son dos hooks de Claude Code, instalados por setup (o por guard install en una configuración existente). Ambos fallan abiertamente: cualquier error, cualquier entrada no analizable, y el comando se ejecuta sin cambios. Ninguno llama a un modelo de lenguaje.

Antes de que un comando se ejecute (PreToolUse en Bash), la guardia juzga el comando contra seis reglas integradas y las reglas que este proyecto recuerda. Una denegación no es un rechazo a que algo suceda; es un rechazo a hacerlo sin supervisión, y cada denegación dice cómo proceder deliberadamente.

Regla integrada	Por qué existe
Reescribir un crontab completo desde una tubería	destruye silenciosamente trabajos programados
DELETE, DROP, TRUNCATE, UPDATE enviados a un cliente de base de datos en vivo	un DELETE con alcance no es prueba de seguridad
Eliminación recursiva fuera de rutas temporales, de compilación y de dependencias	irrecuperable por definición
Push forzado a main, master o prod	sobrescribe commits que existen solo en el remoto
Canalizar un script descargado a un shell	ejecuta código que nadie ha leído
pkill o killall de trabajadores de servidor compartidos por nombre	aborta cada solicitud en curso en un host compartido

Las cadenas entre comillas y los cuerpos de heredoc se eliminan antes de que se ejecuten las reglas, por lo que escribir un comando peligroso en un archivo de notas no es lo mismo que ejecutarlo. La carga útil de ssh host "...", bash -c "..." y un heredoc alimentado a un shell se juzga como si se escribiera directamente.

Reglas desde la memoria. Los recuerdos de reglas (save_rule, o cualquier recuerdo con tipo rule) se compilan en patrones y se almacenan en caché localmente al inicio de la sesión, por lo que la verificación previa no necesita red. Dos fuentes:

• Una línea que lee GUARD: <regex> se usa tal como está escrita, sin distinción de mayúsculas y minúsculas. GUARD: off mantiene una regla solo como asesoramiento.
• Un comando entre comillas invertidas que sigue a NEVER, DO NOT o MUST NOT en la misma oración, cuando tiene forma de comando (un nombre de comando más al menos un argumento, sin marcadores de posición). NEVER run \pkill -u www lsphp`es suficiente. Cuando una regla recordada se activa, el motivo cita la regla y la nombra, y el camino a seguir es ejecutar el comando tú mismo o eliminar la regla condelete_rule`.

Después de un turno (Stop), el guardián revisa el árbol de trabajo: posibles secretos añadidos al código rastreado, versiones que no coinciden entre archivos de lanzamiento, archivos eliminados, grandes eliminaciones netas, una función recién definida en más de un lugar, y gotchas recordados que nombran el proyecto o un archivo tocado. El silencio es la salida correcta para un turno limpio.

El registro. Cada veredicto, incluidos los permisos silenciosos, se añade a ~/.cogmemai/guard-verdicts.jsonl (anular con COGMEMAI_GUARD_LOG) con la decisión, la regla, una copia redactada del comando, la sesión y el directorio de trabajo. guard status lo resume.

Cada herramienta, no solo Claude Code (v3.25.0). Cursor, Codex, Gemini CLI, Cline y scripts simples terminan ejecutando bash -c "<command>", y bash no interactivo obtiene el archivo nombrado en BASH_ENV antes de ejecutar cualquier cosa, con el comando completo en BASH_EXECUTION_STRING. cogmemai-mcp guard shell-install escribe ese archivo y apunta BASH_ENV a él, de modo que cada shell entrega su comando al mismo motor, la misma caché de reglas y el mismo registro, y sale con estado 2 y el motivo en stderr cuando se deniega. zsh está cubierto a través de ZSH_EXECUTION_STRING. Establece COGMEMAI_GUARD_OFF=1 para omitir un proceso; guard shell-remove deshace la instalación. No cubierto: sh -c en sistemas donde sh es dash, y el cuerpo de un archivo de script (solo se juzga la cadena -c).

Lo que no es. No es un sandbox ni un sustituto de git, copias de seguridad o revisión. Una entrada general de Bash en permissions.allow hace que un veredicto de "preguntar" sea inerte, por eso el guardián deniega en lugar de preguntar.

Para cada otra IA (v3.28.0). Los hooks son cómo una herramienta de codificación pregunta. Cualquier otra cosa pregunta con una llamada: la herramienta guard_check (o POST /cogmemai/guard-check, o guardCheck en los SDKs) toma una acción propuesta en palabras simples o como el comando o mensaje exacto, más un kind opcional (comando, acción, mensaje, otro) y context, y responde allow, ask o deny con la regla que aplica. Dos pasadas: una pasada literal en cada nivel (un fragmento que una regla cita y aparece textualmente en la acción), y una pasada juzgada en los niveles de pago contra cada memoria de regla y las líneas NEVER y MUST de la intención del proyecto. El veredicto más estricto gana, y falla abierto: un error es un permiso marcado judged: false. Un asistente de soporte a punto de enviar un mensaje, un agente a punto de gastar, un robot a punto de moverse, todos juzgados por las mismas palabras que guardaste una vez.

Intención

CogmemAi Intent (v3.26.0) es un documento en inglés simple por proyecto, mantenido por CogmemAi en lugar de en el repositorio. Es la fuente de verdad del propietario, escrita para un lector que quizás nunca abra el código.

Escríbelo con la herramienta set_intent (o pide a tu asistente que lo redacte y aprueba las palabras). Cuatro secciones funcionan bien:

# my-shop

## Purpose
A checkout for a small shop. Customers pay by card and get an email receipt.

## Invariants
- NEVER charge a card before the address is validated.
- NEVER run `pkill -u www lsphp` on the shared host.
- Every email goes through the queue, never sent inline.

## Decisions
- Tax is computed after discounts because the accountant said so.

## Out of scope
- Subscriptions.

Cada sesión lo carga justo después de las reglas obligatorias, por encima del corte de truncamiento, para que siempre esté frente al asistente. get_intent devuelve el texto completo; cogmemai-mcp guard intent imprime la copia en caché; cada reemplazo mantiene el texto anterior como una versión.

Los invariantes se aplican. Las oraciones bajo un encabezado que se lee como Invariantes, Reglas, Debe, Nunca o Siempre se compilan exactamente como memorias de reglas: un comando entre comillas invertidas después de NEVER o MUST NOT se convierte en un patrón que el guardián PreToolUse deniega, y las líneas GUARD: <regex> también funcionan. Sin red en ese camino; la caché se actualiza al inicio de la sesión y con guard sync.

Cada turno se verifica. En Stop, el diff del turno (sin preparar, preparado y el encabezado de archivos nuevos, limitado a 16,000 caracteres para que juzgue dentro del presupuesto del hook) se envía al servidor CogmemAi y se juzga contra la intención allí, de modo que el hook mismo nunca llama a un modelo. El resultado vuelve como unas pocas líneas para una persona:

CogmemAi Guard reviewed this turn:
  - Intent check: Charges the card as soon as the form is submitted.
  - Conflicts with your intent ("NEVER charge a card before the address is validated."): The charge now happens before validation.
  - Not in your intent yet: Stores the card number for later. Say "add that to the intent" to record it, or ask for it to be reverted.

Un cambio que la intención ya cubre gana silencio. Establece COGMEMAI_INTENT_VERBOSE=1 para ver el resumen de una línea en cada turno juzgado. Nada se bloquea o edita por la revisión; informa, y tú decides.

El marcador (v3.27.0). Cada verificación se añade a ~/.cogmemai/intent-log.jsonl con el proyecto, el tamaño del diff, el tiempo tomado, cuántos conflictos y brechas se encontraron, y las líneas exactas mostradas. Tres comandos convierten eso en un veredicto sobre la característica misma:

cogmemai-mcp guard intent-status            availability, latency, how often it spoke, precision, closed loops
cogmemai-mcp guard intent-log [n]           the last n notes, numbered, with their grades
cogmemai-mcp guard intent-grade [#] right|wrong [why]   grade a note (default: the latest)

La precisión, correcto dividido por calificado, es el número que decide si la revisión merece su lugar; el objetivo es nueve de diez. Un "bucle cerrado" es una nota de brecha seguida dentro de la hora por una actualización de intención en el mismo proyecto, que es el propietario diciendo "añade eso a la intención" y la característica haciendo su trabajo.

Cualquier trabajo, no solo diffs (v3.28.0). La herramienta review_work (o POST /cogmemai/intent-check con un campo work, o reviewWork en los SDKs) revisa una descripción, una salida, un mensaje o una transcripción completa contra la intención, con la misma forma de resultado: resumen, cubierto, no cubierto, violaciones, cobertura. Pasa intent en línea cuando el proyecto no tiene documento almacenado, para un asistente que juzga una conversación o un robot que verifica una tarea.

Fuera de git (v3.29.0). Cuando la carpeta no es un repositorio, la revisión lee el registro de eventos de edición de la sesión en lugar de git diff, de modo que funciona desde cualquier cwd, y las ediciones dentro de una subcarpeta que es su propio proyecto se juzgan contra la intención de ese proyecto.

Niveles. La verificación juzgada se ejecuta en los niveles de pago, porque cada una es una solicitud de modelo. El nivel gratuito obtiene los invariantes aplicados, la inyección de contexto y cada revisión determinista. El modo de almacenamiento solo local no tiene documento de intención, ya que el juicio necesita el servidor.

Configuración Manual

Si prefieres configurar manualmente en lugar de usar npx cogmemai-mcp setup:

Opción A — Por proyecto (añade .mcp.json a la raíz de tu proyecto):

{
  "mcpServers": {
    "cogmemai": {
      "command": "cogmemai-mcp",
      "env": {
        "COGMEMAI_API_KEY": "cm_your_api_key_here"
      }
    }
  }
}

Para modo local (se requiere clave API gratuita para el registro, los datos permanecen locales):

{
  "mcpServers": {
    "cogmemai": {
      "command": "cogmemai-mcp",
      "env": {
        "COGMEMAI_MODE": "local",
        "COGMEMAI_API_KEY": "cm_your_api_key_here"
      }
    }
  }
}

Opción B — Global (disponible en cada proyecto):

# Cloud (default)
claude mcp add cogmemai cogmemai-mcp -e COGMEMAI_API_KEY=cm_your_api_key_here --scope user

# Local (free API key required, data stays local)
claude mcp add cogmemai cogmemai-mcp -e COGMEMAI_API_KEY=cm_your_api_key_here -e COGMEMAI_MODE=local --scope user

# Hybrid (both)
claude mcp add cogmemai cogmemai-mcp -e COGMEMAI_API_KEY=cm_your_api_key_here -e COGMEMAI_MODE=hybrid --scope user

Funciona Con

Claude Code (Recomendado)

Configuración automática:

npx cogmemai-mcp setup

Cursor

Añade a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "cogmemai": {
      "command": "npx",
      "args": ["-y", "cogmemai-mcp"],
      "env": { "COGMEMAI_API_KEY": "cm_your_api_key_here" }
    }
  }
}

Windsurf

Añade a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "cogmemai": {
      "command": "npx",
      "args": ["-y", "cogmemai-mcp"],
      "env": { "COGMEMAI_API_KEY": "cm_your_api_key_here" }
    }
  }
}

Cline (VS Code)

Abre Configuración de VS Code > Cline > MCP Servers, añade:

{
  "cogmemai": {
    "command": "npx",
    "args": ["-y", "cogmemai-mcp"],
    "env": { "COGMEMAI_API_KEY": "cm_your_api_key_here" }
  }
}

Continue

Añade a ~/.continue/config.yaml:

mcpServers:
  - name: cogmemai
    command: npx
    args: ["-y", "cogmemai-mcp"]
    env:
      COGMEMAI_API_KEY: cm_your_api_key_here

CogmemUI

CogmemUI es un espacio de trabajo de IA multimodelo gratuito con memoria CogmemAi integrada. Añade tu clave API de CogmemAi en Configuración > Claves API y tu memoria estará disponible al instante. CogmemUI también admite conectar cualquier servidor de herramientas compatible con MCP a través de Configuración > Servidores MCP — añade endpoints, descubre herramientas automáticamente y úsalas en el chat.

Obtén tu clave API gratuita en hifriendbot.com/developer.

Herramientas

CogmemAi proporciona 41 herramientas que tu asistente de IA usa automáticamente:

Herramienta	Descripción
preflight	Recuerdo proactivo. Recuerdo rápido para verificar contexto previo antes de hacer cualquier sugerencia
save_memory	Almacena un hecho explícitamente (decisión de arquitectura, preferencia, etc.)
recall_memories	Busca memorias usando lenguaje natural (búsqueda semántica)
extract_memories	La IA extrae hechos de un intercambio de conversación automáticamente
get_project_context	Carga las mejores memorias al inicio de la sesión (con clasificación inteligente, puntuación de salud y reproducción de sesión)
list_memories	Navega por memorias con filtros (paginado, con filtro sin tipo)
update_memory	Actualiza contenido, importancia, alcance, tipo, categoría, tema y etiquetas
delete_memory	Elimina permanentemente una memoria
bulk_delete	Elimina hasta 100 memorias a la vez
bulk_update	Actualiza hasta 50 memorias a la vez (contenido, tipo, categoría, etiquetas, etc.)
get_usage	Verifica tus estadísticas de uso e información de nivel
export_memories	Exporta todas las memorias como JSON para copia de seguridad o transferencia
import_memories	Importa memorias en masa desde una matriz JSON
ingest_document	Introduce un documento (README, documentación de API) para extraer memorias automáticamente
save_session_summary	Guarda un resumen de lo que se logró en esta sesión
list_tags	Ve todas las etiquetas en uso en tus memorias
link_memories	Conecta memorias relacionadas con relaciones nombradas
get_memory_links	Explora el grafo de conocimiento alrededor de una memoria
get_memory_versions	Ve el historial de ediciones de una memoria
get_analytics	Panel de salud de memoria con información de autoajuste (filtrable por proyecto)
promote_memory	Promueve una memoria de proyecto a alcance global
consolidate_memories	Fusiona memorias relacionadas en resúmenes completos usando IA
save_task	Crea una tarea persistente con seguimiento de estado y prioridad
get_tasks	Recupera tareas para el proyecto actual — retoma donde lo dejaste
update_task	Cambia el estado, prioridad o descripción de la tarea mientras trabajas
save_correction	Almacena un patrón de "enfoque incorrecto → enfoque correcto" para evitar errores repetidos
set_reminder	Establece un recordatorio que aparece al inicio de tu próxima sesión
get_stale_memories	Encuentra memorias que pueden estar desactualizadas para revisión o limpieza
get_file_changes	Ve qué archivos cambiaron desde tu última sesión
feedback_memory	Señala si una memoria recordada fue útil o irrelevante para mejorar el recuerdo futuro
generate_skills	Activa la generación de habilidades desde tus correcciones y preferencias — o previsualiza candidatos con ejecución en seco
save_rule	Guarda una regla obligatoria que aparece en cada sesión — omite toda puntuación y decadencia
list_rules	Lista todas las reglas obligatorias para el proyecto actual y/o globalmente
delete_rule	Elimina una regla obligatoria por ID
get_intent	Lee el documento de Intención del proyecto, la fuente de verdad en inglés simple del propietario
set_intent	Crea o reemplaza el documento de Intención del proyecto (versionado; los invariantes son aplicados por el guardián)
guard_check	Pregunta antes de actuar: permite, pregunta o deniega cualquier acción propuesta, contra reglas recordadas y la intención
review_work	Revisa trabajo terminado (descripción, salida, mensaje o transcripción) contra la intención
extract_principles	Activa el Motor de Sabiduría para detectar patrones fácticos en clústeres de memoria

SDKs

Construye tus propias integraciones con la API de CogmemAi:

• JavaScript/TypeScript: npm install cogmemai-sdk — npm · GitHub
• Python: pip install cogmemai — PyPI · GitHub

Tipos de Memoria

Las memorias se categorizan para mejor organización y recuperación:

• identidad — Quién eres, tu rol, equipo
• preferencia — Estilo de codificación, elecciones de herramientas, convenciones
• arquitectura — Diseño del sistema, pila tecnológica, estructura de archivos
• decisión — Por qué elegiste X sobre Y
• error — Problemas conocidos, correcciones, soluciones alternativas
• dependencia — Restricciones de versión, notas de paquetes
• patrón — Patrones reutilizables, convenciones
• contexto — Contexto general del proyecto
• tarea — Tareas persistentes con seguimiento de estado y prioridad
• corrección — Patrones de enfoque incorrecto → enfoque correcto
• recordatorio — Empujones de próxima sesión que expiran automáticamente
• regla — Directivas obligatorias que aparecen en cada sesión, omitiendo toda puntuación y decadencia

Alcance

• Memorias de proyecto — Arquitectura, decisiones, errores específicos de un repositorio. Detectadas automáticamente desde tu repositorio.
• Memorias globales — Tus preferencias de codificación, identidad, elecciones de herramientas. Disponibles en cada proyecto.

Precios

	Gratis	Pro	Equipo	Empresa
Precio	$0	$14.99/mes	$39.99/mes	$99.99/mes
Memorias	500	2,000	10,000	50,000
Extracciones/mes	500	2,000	5,000	20,000
Proyectos	5	20	50	200
Start gratis. Mejora cuando necesites más. O paga por operación con USDC en cadena — sin necesidad de tarjeta de crédito.

Privacidad y Seguridad

• 🛡️ Cifrado resistente a la computación cuántica en reposo. Todas las memorias están cifradas con criptografía resistente a la computación cuántica — tanto en modo nube como en modo local. Protegido contra amenazas actuales y futuras computadoras cuánticas.
• Ningún código fuente sale de tu máquina. Almacenamos hechos extraídos (oraciones cortas), nunca código crudo.
• Claves API con hash criptográfico (irreversible) en el servidor.
• Todo el tráfico a través de HTTPS.
• Sin entrenamiento de modelos con tus datos. Nunca.
• Elimina todo al instante mediante el panel o la herramienta MCP.
• Sin intercambio de datos entre usuarios.

Lee nuestra política de privacidad completa.

Variables de Entorno

Variable	Requerida	Descripción
COGMEMAI_API_KEY	Nube/Híbrido	Tu clave API (comienza con cm_). No necesaria para el modo local.
COGMEMAI_MODE	No	Modo de almacenamiento: cloud (predeterminado), local (los datos permanecen en tu máquina), o hybrid
COGMEMAI_LOCAL_DB	No	Ruta a la base de datos local (predeterminado: ~/.cogmemai/local.db). Se usa en modos local e híbrido.
COGMEMAI_API_URL	No	URL de API personalizada (predeterminado: hifriendbot.com)
COGMEMAI_ENCRYPTION_KEY	No	Frase de contraseña de cifrado personalizada para el modo local. Si no se establece, se genera una clave automáticamente.
COGMEMAI_LOCAL_ENCRYPTION	No	Establece a off para deshabilitar el cifrado local (no recomendado).

Soporte

• Problemas: GitHub Issues
• Documentación: hifriendbot.com/developer

Licencia

MIT — consulta LICENSE

---

Construido por HiFriendbot — Mejores Amigos, Mejores Memorias, Mejor IA. 🛡️ Seguro Cuántico.