Repolode
cyberchitta

cyberchitta/llm-context.py

Uma CLI e um servidor MCP em Python que permitem a agentes de programação e chats obter o contexto de código certo com seleção reutilizável de arquivos baseada em regras.

Estrelas
308
Forks
26
Issues abertas
5
Último commit
há 20 dias

O que é?

llm-context.py é uma ferramenta para incluir os arquivos de código-fonte certos no contexto de um LLM. Em vez de copiar arquivos manualmente ou enviar um repositório inteiro, você descreve a seleção por meio de uma regra: um arquivo YAML com orientações opcionais em Markdown que lista arquivos completos e arquivos de apoio dos quais extrair trechos. A ferramenta então reúne o código correspondente em um único contexto, com uma lista de arquivos que indica o que foi incluído e o que ficou de fora.

As regras podem ser combinadas e são organizadas por categoria, então você pode alternar entre tarefas como revisão de código ou documentação mudando as regras, em vez das listas de arquivos. Os arquivos que você pretende editar são incluídos por inteiro, enquanto o código de apoio é reduzido a assinaturas e definições por meio de análise estrutural do código. Cada pacote inclui um timestamp para que as ferramentas informem quais arquivos estão ausentes ou foram alterados desde sua geração.

O contexto pode ser fornecido de três maneiras: impresso em stdout para ser passado por pipe a um subagente, como claude -p; copiado para a área de transferência e colado em um chat; ou disponibilizado pelo Model Context Protocol, para que um modelo possa solicitar arquivos por conta própria. Executar lc-init instala no projeto uma skill que ensina um agente de programação a criar e verificar essas regras.

Recursos principais

  • 01Seleciona arquivos por meio de regras YAML reutilizáveis, que podem ser combinadas e alternadas conforme a tarefa.
  • 02Inclui o conteúdo completo dos arquivos que você edita e análises estruturais do código dos arquivos de apoio.
  • 03Mostra uma prévia dos arquivos selecionados por uma regra, incluindo símbolos usados, mas não incluídos.
  • 04Gera saída em stdout para ser passada por pipe, copiada para a área de transferência ou fornecida por um servidor MCP.
  • 05Disponibiliza ferramentas MCP para solicitar arquivos ausentes ou alterados durante uma sessão.
  • 06Instala uma skill de agente que cria e verifica regras para o projeto.

Casos de uso

  • Fornecer contexto direcionado a um agente de programação para implementar um recurso específico ou corrigir um bug.
  • Passar código selecionado por pipe para uma execução de subagente iniciada pela linha de comando.
  • Colar um recorte do código no contexto de um modelo de chat para revisão.
  • Manter regras de contexto de um repositório para tarefas de revisão de código e documentação.

Início rápido

  1. 1

    Instale a ferramenta com uv

    uv tool install "llm-context>=0.6.0"
  2. 2

    Execute lc-init na raiz do seu projeto para instalar a skill

    lc-init

Antes de usar

  • A documentação completa fica em um arquivo de agent skill, então o README serve apenas como página inicial.

Em coleções

Tópicos

Perguntas frequentes

O que é llm-context.py?
Uma CLI e um servidor MCP em Python que permitem a agentes de programação e chats obter o contexto de código certo com seleção reutilizável de arquivos baseada em regras. llm-context.py é uma ferramenta para incluir os arquivos de código-fonte certos no contexto de um LLM. Em vez de copiar arquivos manualmente ou enviar um repositório inteiro, você descreve a seleção por meio de uma regra: um arquivo YAML com orientações opcionais em Markdown que lista arquivos completos e arquivos de apoio dos quais extrair trechos. A ferramenta então reúne o código correspondente em um único contexto, com uma lista de arquivos que indica o que foi incluído e o que ficou de fora.
llm-context.py é gratuito? Qual é a licença?
llm-context.py é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
llm-context.py ainda é mantido?
Manutenção ativa. O último commit de llm-context.py foi em 19 de out. de 2026.
Para que posso usar llm-context.py?
Fornecer contexto direcionado a um agente de programação para implementar um recurso específico ou corrigir um bug. Passar código selecionado por pipe para uma execução de subagente iniciada pela linha de comando. Colar um recorte do código no contexto de um modelo de chat para revisão. Manter regras de contexto de um repositório para tarefas de revisão de código e documentação.
Como instalar llm-context.py?
Instale a ferramenta com uv: uv tool install "llm-context>=0.6.0" Execute lc-init na raiz do seu projeto para instalar a skill: lc-init
Onde consigo llm-context.py?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/cyberchitta/llm-context.py

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados