Repolode
Enviar
mksglu

mksglu/context-mode

Servidor MCP para agentes de programação com IA que mantém as saídas brutas das ferramentas fora da janela de contexto e preserva o estado da sessão após a compactação.

Ver no GitHubSite
Estrelas
30,905
Forks
2,302
Issues abertas
356
Último commit
há 9 horas

O que é?

O Context Mode resolve o problema da janela de contexto que agentes de programação com IA enfrentam quando ferramentas MCP retornam grandes volumes de dados brutos, como snapshots de navegador, listas de issues ou arquivos de log. Ele executa as ferramentas em um sandbox para que apenas o resultado final entre na conversa. O projeto relata uma redução de 98% em um exemplo de 315 KB.

Também registra eventos da sessão, como edições de arquivos, operações do git, tarefas, erros e decisões do usuário, em SQLite. Os eventos são indexados com FTS5 e recuperados por busca BM25, permitindo que o agente retome o trabalho com o estado relevante após a compactação da conversa. Sessões que não forem retomadas são apagadas na próxima inicialização.

O projeto é distribuído como servidor MCP e integrado a vários clientes por meio de plugins, hooks e arquivos de configuração, incluindo Claude Code, Gemini CLI, VS Code Copilot, Cursor, OpenCode, Codex CLI e OpenClaw.

Recursos principais

  • 01Executa as saídas das ferramentas em um sandbox para manter os dados brutos fora da janela de contexto.
  • 02Armazena eventos da sessão em SQLite e restaura os relevantes após a compactação.
  • 03Pesquisa conteúdo indexado com FTS5 e classificação BM25.
  • 04Oferece ctx_execute e ferramentas relacionadas para executar scripts que retornam apenas os resultados.
  • 05Usa hooks da plataforma para encaminhar chamadas de ferramentas entre clientes de programação com IA compatíveis.

Casos de uso

  • Sessões longas de programação em que ferramentas MCP, como as que buscam dados de navegadores ou issues, enchem a janela de contexto.
  • Análise de muitos arquivos de código-fonte, pedindo ao agente que escreva um script que retorne apenas um resumo.
  • Retomada do trabalho após a compactação da conversa pelo agente, sem precisar reler o estado anterior.

Início rápido

  1. 1

    Instale o plugin do Claude Code pelo marketplace

    /plugin marketplace add mksglu/context-mode
  2. 2

    Instale o plugin context-mode

    /plugin install context-mode@context-mode
  3. 3

    Reinicie o Claude Code e, em seguida, verifique a instalação com o comando doctor

    /context-mode:ctx-doctor

Antes de usar

  • A configuração automática documentada no README é voltada principalmente ao Claude Code; em outras plataformas, é preciso configurar os arquivos manualmente.
  • A licença é ELv2, que restringe a oferta do software como um serviço hospedado ou gerenciado.
  • Alguns recursos, como o painel do Insight, dependem de um serviço hospedado em context-mode.com.

Tópicos

#mcp#ai-agent#context-window#claude-code#coding-assistant#sqlite#llm-tools#antigravity#claude#claude-code-hooks

Perguntas frequentes

O que é context-mode?
Servidor MCP para agentes de programação com IA que mantém as saídas brutas das ferramentas fora da janela de contexto e preserva o estado da sessão após a compactação. O Context Mode resolve o problema da janela de contexto que agentes de programação com IA enfrentam quando ferramentas MCP retornam grandes volumes de dados brutos, como snapshots de navegador, listas de issues ou arquivos de log. Ele executa as ferramentas em um sandbox para que apenas o resultado final entre na conversa. O projeto relata uma redução de 98% em um exemplo de 315 KB.
context-mode é gratuito? Qual é a licença?
context-mode é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
context-mode ainda é mantido?
Manutenção ativa. O último commit de context-mode foi em 19 de out. de 2026.
Para que posso usar context-mode?
Sessões longas de programação em que ferramentas MCP, como as que buscam dados de navegadores ou issues, enchem a janela de contexto. Análise de muitos arquivos de código-fonte, pedindo ao agente que escreva um script que retorne apenas um resumo. Retomada do trabalho após a compactação da conversa pelo agente, sem precisar reler o estado anterior.
Como instalar context-mode?
Instale o plugin do Claude Code pelo marketplace: /plugin marketplace add mksglu/context-mode Instale o plugin context-mode: /plugin install context-mode@context-mode Reinicie o Claude Code e, em seguida, verifique a instalação com o comando doctor: /context-mode:ctx-doctor
Onde consigo context-mode?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/mksglu/context-mode

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

Projetos relacionados