Contextium: Framework de Contexto Persistente de Código Aberto para Claude Code

Contextium é um framework de contexto persistente de código aberto desenvolvido especificamente para o Claude Code. Ele resolve o problema de ter que reexplicar o contexto em cada nova sessão do Claude Code criando um sistema de repositório estruturado que acumula conhecimento ao longo do tempo.

O que ele faz

Contextium organiza informações em arquivos markdown em várias categorias: aplicativos, integrações, domínios de conhecimento, projetos e diários. O mecanismo central é um arquivo CLAUDE.md que atua como um roteador de contexto, informando ao Claude quais arquivos carregar com base na tarefa atual. Isso evita o inchaço da janela de contexto carregando apenas o conteúdo relevante sob demanda.

Recursos principais

• Tabela de roteamento de contexto: O arquivo CLAUDE.md contém uma tabela de roteamento que aciona carregamentos específicos de arquivos:

  | Gatilho | Carregar |
  |----------------------|-----------------------------------|
  | Trabalho no projeto | projects/README.md |
  | Pessoa mencionada | knowledge/people/{nome}/ |
  | Chamada de integração/API | integrations/{nome}/README.md |
  | Trabalho anterior | journal/ (mais recente) |

• Suporte a múltiplos agentes: Encaminha pesquisas para o Gemini (para eficiência de custo) e edições em massa para o Codex (para velocidade) enquanto mantém o Claude focado em estratégia e decisões
• Estrutura de modelo: A versão de código aberto vem com 6 aplicativos de exemplo e documentação para 27 integrações
• Escala do mundo real: A instância pessoal do criador contém 35 protocolos de aplicativos, 27 conectores de integração, 100+ projetos concluídos com registros de decisão e 600+ entradas de diário

Instalação e configuração

Instale com um único comando:

bash curl -sSL contextium.ai/install | bash

O instalador usa bash e gum para a interface de terminal, pergunta seu nome, seleciona seu agente de IA (suporta Claude Code mais 8 outros), escolhe integrações e configura seu repositório. O processo leva cerca de 5 minutos e funciona em macOS e Linux.

Processo de desenvolvimento

O criador desenvolveu o Contextium ao longo de vários meses usando o Claude Code, que escreveu aproximadamente 90% do código. Isso incluiu:

• O script de instalação (bash + gum)
• Adaptação de 27 READMEs de integração
• Modelos de configuração de agentes
• Um site Astro
• Depuração em várias execuções de teste em VMs novas

Detalhes técnicos

• Licença: Apache 2.0
• GitHub: https://github.com/Ashkaan/contextium
• Site: https://contextium.ai