Lians Agent Memory

Recupere a tarefa. Rejeite estado obsoleto. Bloqueie conclusão não suportada.

Início rápido · Por que Lians · ContinuityBench · Instalação · Documentação · Problemas

Lians Guard

O guardião de estado atual e conclusão para agentes de codificação de IA.

Lians recupera trabalho de agente interrompido, rejeita estado de tarefa obsoleto e bloqueia done até que a tarefa atual esteja pronta para revisão humana.

Seu agente pode esquecer o chat. Ele não pode esquecer o que está concluído, o que mudou ou o que ainda precisa passar.

• Recuperar. Retome uma tarefa atual limitada em sessões suportadas do Claude Code e Codex.
• Rejeitar estado obsoleto. Vincule checkpoints ao repositório atual e ao estado da tarefa para que evidências antigas não sejam reutilizadas silenciosamente.
• Guardar conclusão. Separe evidências medidas das próprias afirmações do agente e mantenha o portão fechado enquanto o trabalho estiver ausente, desconhecido, com falha ou bloqueado.
• Exigir revisão. READY FOR HUMAN REVIEW é uma transferência para uma pessoa, nunca uma afirmação de que o trabalho está correto, aprovado ou seguro para implantar.
• Permanecer local. O caminho gratuito de recuperação não precisa de conta Lians, senha de IA ou chave de API do provedor.

Lians funciona com sua conta de IA e editor existentes. Ele não substitui seu modelo, Git, CI, instruções do repositório ou revisão humana.

Duas camadas, um loop de agente

A camada de código aberto Lians Guard vive dentro do Codex por meio de MCP, skills, hooks e estado do repositório. Ela lembra correções e expõe evidências sem assumir o controle do modelo. A versão beta opcional Lians Mission Control é a camada de controle local: dê a ela uma missão, deixe-a escolher uma rota limitada do Codex e exija um verificador real antes de retornar PASS.

Em versões suportadas do Codex, uma missão do Mission Control agora usa um thread do app-server do Codex em vez de iniciar um novo processo e reproduzir um resumo para cada estágio. O Codex ainda possui autenticação, ferramentas, sandboxes e execução; Lians possui a missão durável, a política de uso e o recibo. O app-server está atualmente experimental, então o adaptador de uma única execução permanece disponível.

Inspecione o código-fonte do Mission Control, leia o limite da ponte ou siga o protocolo externo de portão de prova.

Um resultado claro após cada sessão 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

O modelo de confiança é deliberadamente estrito. measured_local, measured_ci e human_confirmed evidências podem satisfazer um critério. agent_attested e inferred_activity registros permanecem contexto útil, mas não podem abrir o portão de revisão. Um agente não pode promover seu próprio checkpoint para uma classe confiável. Evidências confiáveis de CI exigem uma atestação exata do GitHub e correspondência de commit, além de um mapeamento interativo de verificação para critério; evidências humanas exigem confirmação interativa. Leia por que Lians existe, o contrato completo do produto Lians Guard e o atual teste de pressão de mercado.

Experimente em dois minutos

Escolha a ferramenta de IA que você já usa:

Ferramenta	Configuração mais rápida
App, CLI ou IDE do Codex	Um comando
Claude Code	Dois comandos de plugin
Cursor	Instalação MCP com um clique
Outros clientes MCP	Configuração MCP mínima

Por exemplo, após instalar uv, conecte o Codex com:

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

Reinicie o Codex e salve um fato seguro do projeto e recupere-o em um novo chat. A memória local é armazenada em ~/.lians/mcp.db por padrão. Este é o caminho gratuito de recuperação disponível; o fluxo completo do Guard é atualmente uma prévia para desenvolvedores.

Siga o início rápido completo para configuração, recuperação, correção, exclusão e o limite da prévia do Guard.

O que um novo agente de codificação recebe

Lians pode gerar uma transferência limitada de projeto em vez de reproduzir uma transcrição:

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

A transferência é derivada do estado atual do Lians, não de um resumo mantido manualmente. O trabalho relatado pelo agente permanece visível sem ser rotulado incorretamente como conclusão verificada.

Por que isso não é outra camada de memória genérica

Memórias nativas são convenientes quando o trabalho permanece dentro de um produto. A memória geral não é mais uma categoria escassa. Lians usa memória local para recuperação e depois foca na lacuna cara: estado atual da tarefa e prontidão baseada em evidências.

O cenário competitivo atual testa essa posição contra Claude Code nativo, Codex, Cursor, GitHub Copilot, Entire, Factory e fluxos de revisão de IA.

Abordagem	Melhor ajuste	Limite
Memória nativa da ferramenta	Uma ferramenta de IA, configuração mínima	Geralmente permanece dentro desse fornecedor
AGENTS.md ou CLAUDE.md	Instruções estáveis do repositório	Deve ser mantido manualmente
Reprodução de transcrição	Reconstruir uma conversa	Grande, ruidosa e pode reviver decisões obsoletas
Recuperação gratuita do Lians	Retomar contexto atual do projeto em ferramentas suportadas	Requer uma conexão local com cada ferramenta
Lians Guard	Detectar estado obsoleto e controlar prontidão com evidências tipadas	Fluxo de trabalho em equipe ainda está em prévia para desenvolvedores

Lians não está afirmando que todo projeto precisa de uma camada de memória separada. Veja a comparação honesta e guia de decisão.

Status do projeto

Lians está em desenvolvimento ativo. Os recursos de recuperação disponíveis e os recursos de prévia do Guard estão separados aqui para que o repositório não implique uma garantia de produção que ainda não existe.

Capacidade	Status
Memória local por meio de MCP e Python	Disponível
Configuração de recuperação local para Codex, Claude Code e Cursor	Disponível
Inspeção, correção e exclusão permanente confirmada	Disponível
Contexto limitado e recibos de seleção assinados	Disponível
Transferência automática de projeto Claude para Codex	Beta
Evidências tipadas e portão de tarefa baseado em evidências	Prévia para desenvolvedores
Impressão digital local do workspace Git em checkpoints	Prévia para desenvolvedores
Invalidação automática de evidências obsoletas	Em desenvolvimento
Ingestão de evidências atestadas do GitHub Actions	Prévia para desenvolvedores
Relatórios locais do Guard	Prévia para desenvolvedores
Fila de equipe compartilhada	Planejado
CI de instalação limpa multiplataforma	Exigido pelo novo fluxo do Guard; primeira execução hospedada pendente
Instalador de desktop guiado e centro de controle local	Candidato a lançamento
Beta Protect-versus-Maximum do Mission Control	Candidato; portão de prova pré-registrado
Ponte persistente de uma missão/um thread do Codex	Beta; app-server é experimental

As versões desktop para macOS e Windows permanecem candidatas a lançamento, pendentes de assinatura e notarização da plataforma. Veja o limite da prévia do desktop.

Evidências atuais

O fixture de continuidade Claude para Codex incluído recuperou 10/10 fatos esperados, expôs 0 fatos obsoletos como atuais e produziu uma transferência de 231 tokens. Esses são resultados beta limitados, não uma promessa de que toda sessão de codificação ao vivo extrai perfeitamente. Execute o experimento.

O ContinuityBench v0.1 em desenvolvimento publica o contrato de teste proposto para cross-agent, atualização, correção, apagamento, proveniência e limitação. Seu fixture atual do Lians é evidência apenas para esse fixture; não é apresentado como um ranking de concorrentes concluído.

Um teste ao vivo separado salvou um fato sintético de projeto por meio do Cursor, recuperou-o em um novo chat do Cursor e em uma nova sessão do Claude Code e confirmou que ele foi removido após a exclusão. Leia o método de teste.

O benchmark de correção do Guard exercita evidências ausentes, critérios desconhecidos, restrições com falha, bloqueadores, atualizações obsoletas e sinais de desvio. É um teste local e determinístico da política configurada, não uma prova de correção semântica ou um resultado de produção. Execute packages/lians-easy/benchmarks/task_contract_correctness.py para inspecionar os casos.

Construa com Lians

Use o SDK Python local dentro de um aplicativo:

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?",
)

Veja o guia de instalação para TypeScript, Go, Java, C, integrações de frameworks e auto-hospedagem.

Executando uma turma, clube, hackathon ou grupo de desenvolvedores no campus? Use o kit para estudantes e comunidades. Contribuidores e integradores de pacotes podem começar com Caminhos suportados e status do repositório.

Capacidades avançadas

Lians também inclui ferramentas para transferências de agente com escopo de projeto, recibos assinados de seleção e revisão, briefs locais de pesquisa e navegador, reconstrução temporal, linhagem, barreiras de informação, apagamento confirmado e verificações formais limitadas. Essas capacidades são úteis para implantações avançadas ou governadas, mas não são necessárias para o fluxo de trabalho inicial de memória.

• Mecanismo de memória
• Experimento de continuidade entre agentes
• Verificação de trabalho do agente
• Modelo de segurança
• Limite entre comunidade e produto gerenciado
• Caminhos suportados e status do repositório

Desenvolvimento

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

Leia CONTRIBUTING.md antes de abrir um pull request. Ideias de recursos, solicitações de integração e bugs reproduzíveis são bem-vindos em GitHub Issues.

Se Lians ajuda seu fluxo de trabalho, marque o repositório com estrela para que outros usuários de ferramentas de IA possam encontrá-lo.

Licença

Apache 2.0. Veja LICENSE.