LWC

LWC — Memória Proativa para Agentes de IA

Orientado a Agentes · Persistente · Fundamentado em Fontes

Inglês · 简体中文 · 日本語 · Espanhol · Português (Brasil) · Francês · Russo

lwc é uma CLI de memória proativa orientada a agentes para agentes de IA. Ela permite que Agentes recuperem, mantenham e evoluam autonomamente conhecimento persistente e fundamentado em fontes entre sessões.

Funciona com Claude Code, Codex, Cursor, OpenCode, Gemini CLI, Kiro, Hermes, Antigravity, GitHub Copilot no VS Code, Copilot CLI, Copilot para JetBrains e pi.

O LWC transforma documentos selecionados em um Wiki durável. Os agentes raciocinam e sintetizam; o lwc preserva fontes, páginas, citações, links, índices e histórico para que o conhecimento se acumule em vez de ser redescoberto a partir de fragmentos brutos a cada consulta.

Memória de equipe auto-hospedada — v0.19.3

Os espaços de equipe do LWC mantêm a memória central em SQLite local e arquivos Wiki e a sincronizam automaticamente por meio de um servidor auto-hospedado. Agentes externos resolvem conflitos por meio de CLI/MCP; o LWC não incorpora um LLM. O console da equipe oferece suporte a inglês e chinês simplificado, permissões explícitas de espaço, acesso de dispositivo/Agente e recuperação auditável de memória. Leitores somente em nuvem podem consultar sem criar uma réplica local.

Consulte o guia de implantação, o protocolo e o design de acesso e recuperação. O login por e-mail, Feishu e GitHub usa a configuração de provedor fornecida na implantação.

Entre com uma chave pessoal gerada, selecione um espaço autorizado e provisione um membro com acesso inicial ao espaço em uma única etapa. Compartilhe links de páginas com verificação de permissão e siga links de conhecimento sem sair do leitor. Guia da equipe · Notas de versão.

LWC é Memória de Agente, Não RAG

RAG e LWC podem ambos ajudar um LLM a trabalhar com documentos externos, mas eles mantêm estado em lugares diferentes. Uma solicitação RAG típica recupera fragmentos brutos e constrói uma resposta no momento da consulta:

query -> retrieve chunks -> generate answer

O LWC mantém o trabalho útil entre solicitações:

task -> recall maintained Wiki -> reason from sources and prior synthesis
     -> write durable improvements back

A recuperação é uma operação dentro do LWC, não seu princípio organizador. O artefato durável é um Wiki fundamentado em fontes cujas páginas, citações, links, contradições e histórico são revisados à medida que o conhecimento muda. Portanto, o LWC não exige embeddings ou um banco de dados vetorial, e não descarta cada síntese após responder. Ele pode complementar o RAG, mas não é RAG em tempo de consulta.

O Agente opera o LWC

lwc é uma interface de máquina para Agentes, não um aplicativo de anotações voltado para humanos. Em uso normal, um humano seleciona fontes, define metas, faz perguntas e revisa respostas ou o Markdown projetado. O Agente executa a CLI, gerencia o escopo, integra fontes, mantém citações e links e decide o que vale a pena recuperar ou gravar de volta.

Não conduza manualmente o fluxo de trabalho rotineiro do lwc a menos que esteja desenvolvendo ou depurando a ferramenta. Peça ao seu Agente para ativar a Habilidade canônica using-lwc incluída — geralmente como $using-lwc.

Recomendado: Peça ao Seu Agente para Configurar o LWC

Cole este prompt no Agente que você usa. Ele instala a CLI global, delega toda a configuração de host suportada ao instalador idempotente AgentTarget do LWC e usa autoconfiguração nativa apenas para um Agente não registrado.

Configure LWC completely for this user. Perform and verify the work; do not
merely describe commands for me to run.

Source of truth:
- https://github.com/JanYork/llm-wiki-cli
- https://github.com/JanYork/llm-wiki-cli/tree/main/skills/using-lwc

Requirements:
1. Read this README, `SECURITY.md`, and `skills/using-lwc/SKILL.md`. Install the
   official checksum-verified release if `lwc` is not globally callable; never
   prefix routine commands with a private binary path or `LWC_PROJECT_ROOT`.
2. Run `lwc --version`, initialize global memory once with
   `lwc --scope global init` when missing, then run `lwc agent install --yes`.
   This command detects installed supported Agents and safely installs their
   MCP, Skill, Hook and Instructions using official locations. Do not recreate
   that logic manually or install a native package for the same Agent as well.
3. Inspect `lwc agent status --target all --location global`. Restart affected
   Agents and complete their normal Hook trust review where required. Do not
   initialize a project Wiki or either graph without explicit project consent.
4. If the current runtime is not one of LWC's registered AgentTargets, use its
   official user-level conventions to install the canonical `using-lwc` Skill,
   an additive instruction block, `lwc serve --mcp`, and a bounded session Hook
   only where those surfaces are officially supported. Preserve existing
   configuration, remain idempotent, and report unsupported surfaces instead of
   inventing paths or keys.

Finish with the LWC version, detected and configured Targets, status results,
files changed, unsupported surfaces, and any restart or trust action remaining.

Origem e Agradecimentos

lwc implementa o padrão LLM Wiki proposto por Andrej Karpathy: um LLM constrói e mantém incrementalmente um Wiki persistente e interligado em vez de reconstruir conhecimento a partir de documentos brutos para cada consulta. A arquitetura da CLI e detalhes de implementação selecionados também se inspiram em nashsu/llm_wiki.

Este projeto adapta essas ideias em uma CLI Rust em Rust, priorizando agentes, apoiada por SQLite.

Design Principal

O LWC mantém quatro camadas distintas para que o conhecimento durável permaneça rastreável:

O SQLite é canônico. Markdown, índices de texto completo e armazenamentos de grafos opcionais são projeções reconstruíveis. Os agentes atualizam o conhecimento por meio da CLI; operações bem-sucedidas retornam JSON estruturado que pode ser auditado e retomado.

Leia a visão geral da arquitetura →

Arquivos de Memória Portáteis

Os agentes podem empacotar um Wiki de projeto, ou um Wiki global explicitamente selecionado, em um único arquivo portátil e importá-lo com segurança ou mesclá-lo de forma conservadora em outro armazenamento LWC. O arquivo contém a memória completa em texto simples do Wiki selecionado, portanto, compartilhe-o apenas com um destinatário confiável e trate o conteúdo recebido como dados não confiáveis, e não como instruções.

A memória existente nunca é substituída implicitamente: as importações preparam uma mesclagem retomável, enquanto a sobrescrita de todo o armazenamento exige confirmação humana separada. Índices reconstruíveis e projeções são restaurados após a publicação; Tutor, Book e Practice permanecem independentes do arquivo v1.

Use arquivos de memória portáteis com segurança →

Recuperação Hierárquica e Grafo de Conhecimento

O LWC indexa Fontes e páginas Wiki nos níveis de documento, passagem e frase. Os agentes podem começar com um contexto pequeno em formato de resposta, expandir o trecho exato apenas quando necessário e detectar localizadores desatualizados após mudanças de conteúdo.

O grafo de documentos opcional conecta páginas, fontes, citações, links e relações semânticas explícitas. O SQLite permanece autoritativo, enquanto o Grafeo ou SurrealDB fornece uma camada de travessia reconstruível. Relações explícitas mantêm sua razão, proveniência, confiança e evidência de fonte.

Conversão de Documentos e Leitura de Office

Adaptadores opcionais Anydoc ou MarkItDown convertem arquivos locais suportados em Markdown revisável antes da ingestão. O OfficeCLI fornece um caminho separado, baseado em consentimento e somente leitura para arquivos Word, Excel e PowerPoint. Nenhuma capacidade é instalada ou habilitada silenciosamente, e os arquivos Office de origem nunca são modificados.

A pesquisa de passagens também indexa o caminho de cabeçalho H2-H6 envolvente como um campo independente. O contexto do cabeçalho pode melhorar a correspondência, mas nunca é prefixado ao trecho retornado ou incluído em seu intervalo de bytes, portanto, citações e localizadores de trecho ainda apontam para o texto canônico exato do corpo. A migração 17 do armazenamento reconstrói apenas este índice derivado de trecho/pesquisa.

Explore recuperação e indexação → · Grafo de documentos → · Conversão de documentos →

Suíte de Aprendizado Opcional

Tutor, Book e Practice são capacidades independentes de primeira parte, desabilitadas por padrão e apoiadas por armazenamentos privados separados:

• Tutor mantém turnos de ensino, evidências do aprendiz, metas, planos e um Soul/Wiki privado.
• Book importa livros suportados em ordem de fonte verificada para leitura completa e fundamentada.
• Practice mantém bancos de questões versionados, provas, tentativas, avaliação, flashcards e estado de revisão FSRS.

Cada runtime é baixado lentamente, fixado à versão do LWC e verificado por checksum. Desabilitar uma capacidade preserva seus dados canônicos. As Habilidades do Agente lidam com recuperação e persistência sem expor a contabilidade rotineira ao aprendiz.

Leia os contratos da Suíte de Aprendizado →

Instalação

A maioria dos usuários precisa apenas de um comando de pacote:

npm install --global @i-xor/lwc

Homebrew, crates.io, lançamentos do GitHub verificados por checksum e builds locais de Cargo também são suportados.

Guia de instalação e atualização →

Habilidade de Agente Companheira

A Habilidade using-lwc incluída transforma o LWC em uma camada de memória proativa. Ela recupera contexto limitado, mantém o conhecimento do projeto e global separados, integra fontes, preserva citações e grava de volta apenas conhecimento verificado que vale a pena reutilizar.

Instale-a a partir de skills.sh:

npx skills add JanYork/llm-wiki-cli --skill using-lwc -g

O gatilho canônico é $using-lwc. A Habilidade é neutra em relação ao runtime e inclui orientação focada para memória, grafos de documentos, Word Graph, CodeGraph, tags fortes, conversão, integração, recuperação e manutenção.

Configuração nativa do Agente

O LWC detecta Agentes suportados e instala suas superfícies disponíveis de MCP, Skill, Hook e Instructions por meio de adaptadores AgentTarget idempotentes:

lwc agent install --yes

O MCP unificado somente leitura expõe memória Wiki limitada e contexto de código opcional sem ampliar o espaço de trabalho ativo. Os 12 alvos registrados são Claude Code, Cursor, Codex, OpenCode, Hermes, Gemini CLI, Antigravity, Kiro, GitHub Copilot no VS Code, Copilot CLI, Copilot para JetBrains e pi.

agent status relata hook_capabilities verificado separadamente dos eventos nativos realmente gravados como installed_hook_events para esse escopo. Consentimento restrito de shell é aplicado como uma solicitação apenas para Claude Code, Cursor, Hermes global e Antigravity; o Codex recebe contexto adicional consultivo e não pode aplicar a solicitação. Eventos de consentimento não suportados não são instalados e retornam um no-op exato. Apenas Claude Code e Codex podem continuar um Plano ativo acionável de Stop, uma vez por proteção de loop nativo; outras superfícies de Stop não são simuladas. Atualizar e desinstalar removem apenas entradas de hook de propriedade do LWC, incluindo entradas dentro de grupos compartilhados, preservando a configuração irmã e do usuário.

As capacidades de grafo permanecem cientes do consentimento: relações de documentos exigem o grafo físico, tarefas de estrutura de código exigem CodeGraph, e nenhuma é habilitada apenas porque seu runtime existe. A leitura de Office segue o mesmo limite explícito de consentimento.

Integração AgentTarget →

Início Rápido

Humanos normalmente descrevem a meta e revisam o resultado; o Agente opera a CLI. O passo a passo completo está na página Wiki de Início Rápido.

1. Inicialize um Wiki de projeto

O Agente cria um Wiki local ao projeto e define seu propósito e regras de manutenção. O estado do projeto é excluído localmente do Git, a menos que versioná-lo tenha sido uma escolha explícita.

2. Adicione material de fonte

Arquivos selecionados tornam-se instantâneos imutáveis e deduplicados. O LWC rastreia seus caminhos ativos e pode relatar se o arquivo atual está inalterado, modificado, ausente ou substituído.

3. Analise e integre uma fonte

O Agente lê a fonte limitada completa, escreve um resumo da fonte citado, atualiza o conhecimento compartilhado e conclui a ingestão somente após ambas as camadas estarem consistentes.

4. Consulte o Wiki acumulado

A pesquisa é primeiro por página e fundamentada em fontes. Os agentes recuperam respostas mantidas primeiro e, em seguida, abrem evidências exatas da fonte quando uma afirmação precisa de verificação.

Fluxo de Trabalho do Agente

O loop normal é curto:

1. Recupere o conhecimento mantido relevante.
2. Inspecione as fontes ou o código atuais quando a atualidade for importante.
3. Faça a menor atualização verificada.
4. Valide a recuperação, os links e as projeções de grafo aplicáveis.

Revisões amplas usam um changeset atômico. Consulte o fluxo de trabalho completo do Agent para limites de confiança, pré-condições, recuperação e evidência de conclusão.

Memória Temporal

A memória temporal registra eventos compactos sobre o que mudou, por que uma decisão foi tomada, o que foi tentado, o resultado e o que permanece sem resolução. Ela complementa a Wiki: a recordação temporal explica o histórico; a Wiki representa o conhecimento estável atual.

A retenção é limitada e protege registros fixados, não resolvidos e de contradição aberta. Os eventos são normalizados em vez de armazenados como transcrições brutas de chat, e eventos semelhantes nunca são mesclados silenciosamente.

Guia de memória persistente →

Sincronização Multi-máquina

A sincronização reconcilia a memória do projeto, a memória global ou ambas via SSH, mantendo o estado semântico da Wiki separado da publicação Git. A mesclagem preserva objetos exclusivos de ambos os lados; conflitos são retornados como pacotes limitados para resolução explícita.

As sessões são duráveis e retomáveis. O LWC nunca copia o banco de dados SQLite ativo, nem os arquivos WAL ou SHM, nunca redefine a árvore de trabalho e mantém a publicação canônica separada das projeções de busca e grafo reconstruíveis.

Fluxo de sincronização e contrato de segurança →

Alterações Atômicas Multi-comando

Os changesets mantêm uma atualização de conhecimento em várias etapas invisível até que seja revisada e validada. O commit publica apenas entidades canônicas tocadas em uma única transação; trabalho ativo não relacionado sobrevive, e conflitos de revisão da mesma entidade falham de forma segura.

Um commit bem-sucedido registra um patch inverso exato para operações suportadas, permitindo rollback protegido sem substituir a Wiki inteira.

Leituras de rascunho veem gravações em estágio, enquanto o SQLite ativo e o Markdown permanecem inalterados. O banco de dados de rascunho começa como uma pequena sobreposição esparsa; ele não copia nem faz checkpoint da Wiki ativa. changeset show relata operações em estágio, revisões e prontidão sem executar lint. O commit valida e aplica apenas entidades tocadas, então gravações ativas não relacionadas sobrevivem; um conflito de revisão da mesma entidade falha sem sobrescrever nenhum dos lados. O commit rejeita rascunhos vazios e erros de lint bloqueantes; avisos e informações permanecem como orientação de revisão e não bloqueiam a publicação. Não há força ou mesclagem automática. Use --allow-lint-issues --reason "reviewed pre-existing debt" apenas para dívida auditada que o changeset não introduziu. Após o commit, execute novamente as mesmas verificações de recuperação fixas contra o estado ativo. O commit congela o rascunho revisado antes da publicação; changeset_frozen bloqueia qualquer gravação em estágio posterior. Repita o mesmo commit para recuperação ou descarte após um conflito relatado— nunca adicione mais trabalho a um rascunho congelado.

lwc --scope project changeset discard architecture-refresh
lwc --scope project changeset rollback <CHANGESET_ID>

O descarte toca apenas um rascunho não confirmado. O commit grava um patch inverso com soma de verificação contendo apenas entidades tocadas e retorna o ID de rollback exato; o rollback restaura apenas essas entidades e recusa se uma delas mudar novamente. Changesets de projeto e globais são separados, --scope all é inválido, e init, maintenance, checkpoint e comandos de changeset aninhados rejeitam --changeset. Rascunhos nunca criam uma segunda projeção Markdown. Se um erro estruturado relatar committed=true com trabalho de limpeza ou materialização restante, não repita as alterações de conhecimento; execute a ação de recuperação retornada.

O commit esparso atualmente tem patches exatos para adicionar/ingerir Source, colocar/remover Page, esquema, propósito e operações de busca registradas. Mutações de peso de recuperação e relação semântica explícita falham antes do checkpoint ou de obter um bloqueio de gravação ativo com changeset_sparse_unsupported; aplique-as como transações diretas de entidade única até que seus patches inversos esparsos estejam disponíveis.

Guia de changesets →

Escopos

Gravações sempre visam um armazenamento explícito. O LWC nunca cria citações ou links implícitos entre projetos.

Escopos e descoberta de projetos →

Busca e CJK

A busca é lexical, determinística e prioriza páginas. Ela mantém título, caminho, resumo, corpo, proveniência e evidência de grafo distintos; suporta filtros de página/fonte/tipo; e pode explicar a aritmética exata da pontuação.

Texto CJK usa bigramas adjacentes mais unigramas úteis, enquanto texto latino usa termos alfanuméricos em minúsculas. Este design sem dicionário permanece estável para nomes de produtos, símbolos de código, texto em idioma misto e vocabulário emergente.

Pesos de recuperação explícitos e feedback

Pesos de documento auditáveis capturam importância durável. O feedback específico de consulta reclassifica apenas candidatos correspondentes e armazena uma impressão digital em vez da consulta bruta. Nenhum mecanismo pode fazer conteúdo não relacionado aparecer.

Guia de busca e contexto →

Visualizador Somente Leitura e CodeGraph

lwc view inicia um inspetor de projeto em primeiro plano, somente loopback, e abre o navegador. Ele serve um único aplicativo TS + Lit embutido— sem CDN e sem runtime Node no momento do uso—e expõe apenas APIs GET/HEAD. Páginas, fontes, Markdown, o grafo de conhecimento e o grafo de código opcional são lidos do projeto atual sem migração, atualização ou construção de grafo:

lwc view
lwc view --port 4173 --no-open

O detalhe da página usa o título canônico, resumo, tipo, proveniência, citações e carimbos de data/hora. O visualizador suprime apenas um H1 de corpo inicial que corresponde ao título canônico e deriva um sumário local de três ou mais cabeçalhos H2-H4. Essas regras de apresentação nunca reescrevem conteúdo canônico ou Markdown projetado.

O visualizador inicia em inglês. Use o controle 中文 / EN para alternar idiomas; o navegador lembra a seleção enquanto o conteúdo da Wiki permanece no idioma em que foi escrito. Os grafos usam uma única visualização de relacionamento 3D inspirada no Obsidian com nós pequenos, rótulos persistentes, links finos, rotação e zoom.

O CodeGraph é somente do projeto e explicitamente inicializado. Ele responde perguntas sobre símbolos, chamadores, chamados, dependências, arquivos e impacto, mantendo a telemetria desativada e gravações de grafo atômicas por arquivo proprietário.

O runtime fixado reconhece TypeScript, TSX, JavaScript, JSX, ArkTS, Python, Go, Rust, Java, C, C++, C#, Razor, PHP, Ruby, Swift, Kotlin, Dart, Svelte, Vue, Astro, Liquid, Pascal, Scala, Lua, Luau, Objective-C, R, Solidity, Nix, YAML, Twig, XML, .properties, CFML, CFScript, CFQuery, COBOL, VB.NET, Erlang e Terraform.

Guia do visualizador → · Guia do CodeGraph →

Manutenção e Projeção

Lint, reindexação, materialização Markdown, compactação, checkpoints e projeção de grafo são operações explícitas. Trabalho de longa duração é durável, observável, retomável e aplicado em unidades de documento limitadas.

O SQLite permanece canônico durante todo o processo. Índices de busca, Markdown e armazenamentos de grafo podem ser reconstruídos sem reescrever o histórico da fonte ou o conhecimento atual da Wiki.

lwc lint mantém total e counts como campos de compatibilidade para todos os problemas e adiciona blocking_total para erros, além de advisory_total para avisos e informações. A orientação determinística de Markdown atualmente relata H1s de corpo conflitantes ou duplicados, o primeiro salto de nível de cabeçalho e uma região de prosa longa sem seções; apenas erros de integridade bloqueiam o commit do changeset.

Notas:

• Comandos de manutenção retornam um work durável imediatamente. Leia o progresso com work status, ou use work watch e inspecione work.result após o sucesso. A migração de esquema v10 para v11 usa o mesmo mecanismo automaticamente, então comandos normais nunca executam essa migração inline.
• lint é somente leitura por padrão. Adicione --record apenas quando a passagem de lint pertencer ao histórico de operações duráveis.
• maintenance reindex reconstrói artefatos de busca derivados do SQLite.
• maintenance materialize reconstrói a árvore Markdown projetada do SQLite.
• maintenance compact apenas tenta um checkpoint de truncamento WAL; ele não oculta uma otimização FTS completa. Execute-o enquanto a Wiki estiver ociosa e inspecione busy além de after_bytes. Um leitor ocupado retorna prontamente sem alterar o conteúdo canônico.
• Consultas de busca são privadas por padrão; adicione --record apenas quando quiser que o texto da consulta seja armazenado no log de operações duráveis.

lwc checkpoint create <NAME> usa a API de backup online do SQLite. Restaure com lwc checkpoint restore <NAME>; o LWC primeiro cria um checkpoint de segurança pre-restore-* e depois reconstrói a projeção. Use source remove <ID> e page remove <SLUG> para exclusão protegida: fontes com citações e páginas com links de entrada são recusadas. Remover a fonte atual de um caminho rastreado interrompe o rastreamento desse caminho em vez de expor silenciosamente uma revisão mais antiga como atual.

Para uma ingestão de múltiplas fontes ou substituição ampla de páginas, prefira um changeset a um checkpoint manual: um commit bem-sucedido grava um patch inverso esparso, publica apenas entidades canônicas tocadas em uma única transação e materializa incrementalmente o Markdown alterado. O commit tenta um truncamento WAL após a publicação; wal_checkpointed=false significa que um leitor ativo o impediu e não significa que o commit canônico falhou.

Para um backup de sistema de arquivos externo, pare comandos lwc ativos e copie o diretório .lwc/ completo. Não copie apenas wiki.db enquanto um gravador ainda pode estar usando seus arquivos WAL.

Manutenção e diagnósticos →

Suíte de Benchmark

O benchmark opcional mede tempo de importação, latência de busca, Recall@5/10, MRR e armazenamento em um corpus sanitizado fornecido pelo chamador. Comparações justas fixam a máquina, o corpus, o conjunto de consultas e as condições de execução, e então comparam medianas de execuções repetidas.

Metodologia de benchmark →

Resultados de recuperação LongMemEval-S (v0.18.5)

Esta é uma linha de base de recuperação não ajustada, não um teto para a eficácia do LWC com uso contínuo. Em fluxos de trabalho reais, o modelo pode avaliar proativamente evidências e reagir a correções do usuário ou feedback de relevância, atualizando continuamente pesos de documentos e feedback de consulta. Com feedback confiável e ajuste sustentado, espera-se que a recuperação melhore além desta linha de base estática; esse ganho adicional não foi quantificado aqui. Ajuste reativo significa atualizações do Agent acionadas por feedback, não aprendizado automático em segundo plano em cada consulta.

Em 13 de setembro de 2026, duas execuções locais completas processaram 500/500 perguntas, com 470 perguntas pontuadas por recuperação, usando o conjunto de dados LongMemEval-S fixado e quatro trabalhadores concorrentes em um Apple M5 Pro Mac. A segunda execução reutilizou as fontes armazenadas da primeira; todas as 500 listas de resultados classificados foram idênticas.

Estes resultados excluem ajuste proativo. O adaptador recupera fontes de sessão brutas sem curadoria de conhecimento orientada por modelo, feedback de relevância ou atualizações de pesos. Em fluxos de trabalho reais de Agent, um modelo pode avaliar evidências proativamente, curar conhecimento e ajustar explicitamente pesos de documentos ou feedback específico de consulta para melhorar a recuperação subsequente. Este é um fluxo de trabalho de Agent orientado por evidências, não mudanças automáticas de pesos em cada busca; os ganhos dependem da qualidade do feedback e não foram medidos aqui. Avalie o ajuste em perguntas retidas, em vez de alimentar respostas de teste de volta na mesma avaliação.

Estes são resultados de recuperação local, não pontuações oficiais de leaderboard ou precisão de respostas. As latências descrevem carga de quatro workers, não uma comparação controlada de aceleração de versão. Dados da primeira execução · Dados da segunda execução · Reprodução e pontuação.

Todo durável e Plano atual

Todo armazena trabalho adiado; Plano armazena o objetivo atualmente em execução, passos ordenados, progresso e revisão. Eles são capacidades independentes e opcionais e nunca se convertem automaticamente um no outro.

O contexto de ciclo de vida limitado isola o progresso de Plano e Todo por sessão de Agent e, onde o host expõe, por subagente. Cada Agent vê apenas trabalho explicitamente rastreado para seu contexto opaco; comandos detalhados e limites de capacidade do host estão no guia de fluxo de trabalho.

Fluxo de trabalho de Todo e Plano →

Limites e Não-Objetivos

Restrições atuais de design:

• base de conhecimento de máquina única e usuário único;
• fluxo de trabalho de texto UTF-8;
• tamanho de entrada limitado a 64 MiB por schema, propósito, fonte ou corpo de página;
• busca lexical, não recuperação vetorial semântica.

Não-objetivos deliberados para este CLI:

• sem chamadas LLM integradas;
• sem banco de dados vetorial;
• sem daemon ou serviço em segundo plano;
• sem UI web ou UI desktop;
• sem contrato de edição direta de banco de dados.

Se o Markdown projetado divergir, reconstrua-o. Se o schema SQLite estiver errado, corrija-o através do CLI e migrações, não manualmente.

Contribuindo

Issues e pull requests são bem-vindos, especialmente em relação a:

• ergonomia de fluxo de trabalho de Agent;
• comportamento determinístico de projeção;
• contratos duráveis de citação e manutenção de páginas;
• qualidade de busca para corpora técnicos multilíngues.

Por favor, leia CONTRIBUTING.md antes de abrir um pull request. Relate problemas de segurança de acordo com SECURITY.md.

Licença

Licenciado sob a Apache License 2.0.

Novo na 0.18.0

Registros duráveis de Discussão preservam Q/A de esclarecimento visível no SQLite com correções granulares e resumos vinculados a evidências. CodeGraph suporta passagem de resultado nativa, e contratos de Agent e saída de recuperação são mais fáceis de descobrir. Codex também suporta um pacote de plugin nativo; outras rotas de instalação de host permanecem inalteradas. Veja Discussão e Plugin Codex.