Lians Agent Memory

Recupera la tarea. Rechaza el estado obsoleto. Bloquea lo no soportado hasta que esté listo.

Inicio rápido · Por qué Lians · ContinuityBench · Instalación · Documentación · Problemas

Lians Guard

El guardián del estado actual y de la finalización para agentes de codificación con IA.

Lians recupera el trabajo interrumpido del agente, rechaza el estado de tarea obsoleto y bloquea done hasta que la tarea actual esté lista para la revisión humana.

Tu agente puede olvidar el chat. No puede olvidar lo que está terminado, lo que cambió o lo que aún debe pasar.

• Recupera. Reanuda una tarea actual acotada en sesiones compatibles de Claude Code y Codex.
• Rechaza el estado obsoleto. Vincula los puntos de control al estado actual del repositorio y de la tarea para que la evidencia antigua no se reutilice en silencio.
• Guarda la finalización. Separa la evidencia medida de las afirmaciones del propio agente y mantén la puerta cerrada mientras falte trabajo, sea desconocido, haya fallado o esté bloqueado.
• Exige revisión. READY FOR HUMAN REVIEW es una entrega a una persona, nunca una afirmación de que el trabajo sea correcto, esté aprobado o sea seguro de implementar.
• Mantente local. La ruta de recuperación gratuita no necesita cuenta de Lians, contraseña de IA ni clave de API del proveedor.

Lians funciona con tu cuenta de IA y editor existentes. No reemplaza tu modelo, Git, CI, instrucciones del repositorio ni la revisión humana.

Dos capas, un bucle de agente

La capa de código abierto Lians Guard vive dentro de Codex mediante MCP, habilidades, hooks y estado del repositorio. Recuerda correcciones y expone evidencia sin hacerse cargo del modelo. La versión beta opcional Lians Mission Control es la capa de control local: dale una misión, deja que elija una ruta acotada de Codex y exige un verificador real antes de que devuelva PASS.

En versiones compatibles de Codex, una misión de Mission Control ahora usa un subproceso del servidor de la aplicación de Codex en lugar de iniciar un nuevo proceso y reproducir un resumen para cada etapa. Codex sigue siendo dueño de la autenticación, las herramientas, los sandboxes y la ejecución; Lians es dueño de la misión duradera, la política de uso y el recibo. El servidor de la aplicación es actualmente experimental, por lo que el adaptador de una sola ejecución sigue disponible.

Inspecciona el código fuente de Mission Control, lee el límite del puente o sigue el protocolo externo de puerta de prueba.

Un resultado claro después de cada sesión de agente

RECOVERED
Task: Fix OAuth callback handling
Next: Re-run the callback integration test

STALE
Reason: The authentication requirement changed after this checkpoint

BLOCKED
Missing: OAuth callback integration test
Untrusted: "tests passed" was reported by the agent, not measured

READY FOR HUMAN REVIEW
Measured locally: callback tests passed
Measured by CI: required checks passed

El modelo de confianza es deliberadamente estricto. measured_local, measured_ci y human_confirmed la evidencia puede satisfacer un criterio. agent_attested y inferred_activity los registros siguen siendo contexto útil, pero no pueden abrir la puerta de revisión. Un agente no puede promover su propio punto de control a una clase de confianza. La evidencia de CI confiable requiere una atestación exacta de GitHub y una coincidencia de confirmación más un mapeo interactivo de verificación a criterio; la evidencia humana requiere confirmación interactiva. Lee por qué existe Lians, el contrato completo del producto Lians Guard y la prueba de presión de mercado actual.

Pruébalo en dos minutos

Elige la herramienta de IA que ya usas:

Herramienta	Configuración más rápida
Aplicación, CLI o IDE de Codex	Un comando
Claude Code	Dos comandos de plugin
Cursor	Instalación MCP con un clic
Otros clientes MCP	Configuración MCP mínima

Por ejemplo, después de instalar uv, conecta Codex con:

codex mcp add lians --env LIANS_MCP_ENABLED_TOOLS=remember,recall,list_memories,correct_memory,forget_memory -- uvx --from "lians-sdk[mcp]" lians-mcp

Reinicia Codex, luego guarda un hecho de proyecto seguro y recupéralo en un chat nuevo. La memoria local se almacena en ~/.lians/mcp.db de forma predeterminada. Esta es la ruta de recuperación gratuita disponible; el flujo de trabajo completo de Guard es actualmente una vista previa para desarrolladores.

Sigue la guía de inicio rápido completa para configuración, recuperación, corrección, eliminación y el límite de la vista previa de Guard.

Lo que recibe un agente de codificación nuevo

Lians puede generar una entrega de proyecto acotada en lugar de reproducir una transcripción:

Reported complete; verify:
- migrated the orders API to /v2/orders

Still open:
- verify the migration against current Git state
- update documentation

Decisions:
- keep pytest

Changed:
- /v1/orders is stale; use /v2/orders

Next:
- update documentation before touching unrelated UI

La entrega se deriva del estado actual de Lians, no de un resumen mantenido manualmente. El trabajo informado por el agente sigue siendo visible sin etiquetarse erróneamente como finalización verificada.

Por qué esto no es otra capa de memoria genérica

Las memorias nativas son convenientes cuando el trabajo permanece dentro de un solo producto. La memoria general ya no es una categoría escasa. Lians usa memoria local para la recuperación y luego se enfoca en la brecha costosa: el estado actual de la tarea y la preparación respaldada por evidencia.

El panorama competitivo actual pone a prueba esta posición contra Claude Code nativo, Codex, Cursor, GitHub Copilot, Entire, Factory y flujos de trabajo de revisión de IA.

Enfoque	Mejor ajuste	Límite
Memoria nativa de la herramienta	Una herramienta de IA, configuración mínima	Generalmente permanece dentro de ese proveedor
AGENTS.md o CLAUDE.md	Instrucciones estables del repositorio	Debe mantenerse manualmente
Reproducción de transcripción	Reconstruir una conversación	Grande, ruidosa y puede revivir decisiones obsoletas
Recuperación gratuita de Lians	Reanudar el contexto del proyecto actual en herramientas compatibles	Requiere una conexión local a cada herramienta
Lians Guard	Detectar estado obsoleto y controlar la preparación con evidencia tipada	El flujo de trabajo del equipo aún está en vista previa para desarrolladores

Lians no afirma que cada proyecto necesite una capa de memoria separada. Consulta la comparación honesta y la guía de decisión.

Estado del proyecto

Lians está en desarrollo activo. Las funciones de recuperación disponibles y las funciones de vista previa de Guard están separadas aquí para que el repositorio no implique una garantía de producción que aún no existe.

Capacidad	Estado
Memoria local mediante MCP y Python	Disponible
Configuración de recuperación local para Codex, Claude Code y Cursor	Disponible
Inspección, corrección y eliminación permanente confirmada	Disponible
Contexto acotado y recibos de selección firmados	Disponible
Entrega automática de proyecto de Claude a Codex	Beta
Evidencia tipada y puerta de tarea respaldada por evidencia	Vista previa para desarrolladores
Huella digital del espacio de trabajo Git local en puntos de control	Vista previa para desarrolladores
Invalidación automática de evidencia obsoleta	En desarrollo
Ingesta de evidencia atestada de GitHub Actions	Vista previa para desarrolladores
Informes locales de Guard	Vista previa para desarrolladores
Cola de equipo compartida	Planificado
CI de instalación limpia multiplataforma	Requerido por el nuevo flujo de trabajo de Guard; primera ejecución alojada pendiente
Instalador de escritorio guiado y centro de control local	Candidato a versión final
Beta de Mission Control Protect-versus-Maximum	Candidato; puerta de prueba preregistrada
Puente persistente de una misión/un subproceso de Codex	Beta; el servidor de la aplicación es experimental

Las compilaciones de escritorio para macOS y Windows siguen siendo candidatas a versión final pendientes de firma y notarización de la plataforma. Consulta el límite de la vista previa de escritorio.

Evidencia actual

El fixture de continuidad incluido de Claude a Codex recuperó 10/10 hechos esperados, expuso 0 hechos obsoletos como actuales y produjo una entrega de 231 tokens. Estos son resultados beta acotados, no una promesa de que cada sesión de codificación en vivo se extraiga perfectamente. Ejecuta el experimento.

El ContinuityBench v0.1 en desarrollo publica el contrato de prueba propuesto entre agentes, de frescura, corrección, borrado, procedencia y acotación. Su fixture actual de Lians es evidencia solo para ese fixture; no se presenta como una tabla de clasificación de competidores completa.

Una prueba en vivo separada guardó un hecho de proyecto sintético mediante Cursor, lo recordó en un chat nuevo de Cursor y en una sesión nueva de Claude Code, y confirmó que desapareció después de la eliminación. Lee el método de prueba.

El benchmark de corrección de Guard ejercita evidencia faltante, criterios desconocidos, restricciones fallidas, bloqueadores, actualizaciones obsoletas y señales de deriva. Es una prueba local y determinista de la política configurada, no una prueba de corrección semántica ni un resultado de producción. Ejecuta packages/lians-easy/benchmarks/task_contract_correctness.py para inspeccionar los casos.

Construye con Lians

Usa el SDK local de Python dentro de una aplicación:

pip install "lians-sdk[local]"

from datetime import datetime, timezone
from lians import LocalLiansClient

memory = LocalLiansClient(db_path=".lians/memory.db")
memory.add(
    agent_id="my-agent",
    content="The project uses Python 3.12 and pytest.",
    event_time=datetime.now(timezone.utc),
)

result = memory.recall(
    agent_id="my-agent",
    query="Which Python version and test runner should I use?",
)

Consulta la guía de instalación para TypeScript, Go, Java, C, integraciones de frameworks y autoalojamiento.

¿Diriges una clase, club, hackathon o grupo de desarrolladores universitario? Usa el kit para estudiantes y comunidades. Los contribuyentes y los integradores de paquetes pueden comenzar con Rutas compatibles y estado del repositorio.

Capacidades avanzadas

Lians también incluye herramientas para entregas de agente acotadas al proyecto, recibos de selección y revisión firmados, investigación local y resúmenes de navegador, reconstrucción temporal, linaje, barreras de información, borrado confirmado y verificaciones formales acotadas. Estas capacidades son útiles para implementaciones avanzadas o gobernadas, pero no son necesarias para el flujo de trabajo de memoria inicial.

• Motor de memoria
• Experimento de continuidad entre agentes
• Verificación de trabajo del agente
• Modelo de seguridad
• Límite entre producto comunitario y gestionado
• Rutas compatibles y estado del repositorio

Desarrollo

git clone https://github.com/Lians-ai/Lians.git
cd Lians
python -m pip install -e ".[dev]"
python scripts/test_all.py

Lee CONTRIBUTING.md antes de abrir una solicitud de extracción. Las ideas de funciones, las solicitudes de integración y los errores reproducibles son bienvenidos en GitHub Issues.

Si Lians ayuda a tu flujo de trabajo, marca el repositorio con una estrella para que otros usuarios de herramientas de IA puedan encontrarlo.

Licencia

Apache 2.0. Consulta LICENSE.