Contexty — uma ferramenta que permite ao desenvolvedor ver e controlar diretamente o contexto da IA
(github.com/ttalkkak-lab)"Por que a sua IA sempre parece mais burra do que dizem por aí"
- À medida que o contexto se acumula, dá a sensação de que o desempenho do modelo vai piorando
- Ao passar para um novo chat, é preciso explicar de novo as premissas anteriores toda vez
- Ao usar
/compact, perde-se contexto demais - Não dá para saber "quais arquivos e códigos exatamente a IA está vendo agora para ter chegado a essa conclusão"
No livro do líder sênior de engenharia do Google, Addy Osmani, problemas parecidos também já foram apontados. A IA gera código rapidamente, mas a qualidade da arquitetura e a gestão de contexto continuam sendo algo que, no fim, precisa de supervisão humana.
Por isso, apresentamos uma ferramenta open source criada por uma equipe de alunos do curso de Desenvolvimento de Software da Busan Software Meister High School para resolver esse problema diretamente.
Contexty — uma ferramenta que permite ao desenvolvedor ver e controlar diretamente o contexto da IA.
GitHub: https://github.com/ttalkkak-lab/opencode-contexty
Principais recursos
HSCMM (Human-supervised Context Management)
Visualiza em tempo real, em formato de árvore, o contexto que a IA está consultando no momento no painel VSCode Context Explorer
Permite verificar arquivos, pastas e até linhas específicas de código incluídas
Partes desnecessárias podem ser removidas imediatamente, e arquivos ou trechos de código necessários podem ser adicionados manualmente
As linhas incluídas no contexto são destacadas no editor, facilitando a identificação visual
AASM (Active Agent-supervised Architecture)
Um Sub-Agent que detecta antecipadamente antipadrões de arquitetura já na etapa de prompt
Colocar toda a lógica em um único arquivo
Criar um God Object
Abusar de estado global mutável
A IA avisa ou bloqueia esses erros comuns antes de gerar o código.
DCP (Dynamic Context Pruning)
Antes de atingir o limite de contexto, faz compressão automática e mostra com transparência o que foi comprimido e quantos tokens foram economizados. Se necessário, também é possível restaurar (decompress) as partes comprimidas.
ACPM (Agent Context Permission Management)
Controla de forma detalhada as ferramentas que a IA pode usar (file-read, file-write, shell, web etc.) e as permissões de caminho de arquivos.
Pode ser salvo como preset para ser carregado facilmente por projeto.
Como instalar
npx @ttalkkak-lab/opencode-contexty init
Após executar o comando e escolher a IDE, a extensão do OpenCode e a extensão da IDE são instaladas automaticamente, mas a maior parte dos recursos também pode ser usada apenas com a CLI.
As ferramentas de codificação com IA estão ficando cada vez mais poderosas, mas ainda faltam ferramentas que permitam ao desenvolvedor entender com clareza e controlar "o que a IA está vendo agora". O Contexty é um projeto que começou para preencher essa lacuna.
Se tiver interesse, visite o repositório no GitHub — estrelas, feedback, relatórios de bugs, sugestões de recursos e PRs são sempre bem-vindos!
2 comentários
Uau, muito legal~!
Alterado para o título original e movido para Show.
Por favor, publique o título do post consultando o guia de uso do GeekNews.
Como posts cuja categoria foi ajustada por um moderador podem ter a exibição na página inicial limitada, pedimos que confira a categoria mais uma vez antes de publicar.