O que codeprism faz?
Salvamento de contexto local-first para agentes de codificação de IA: mapeie primeiro, fatie depois, recupere exatamente.
Visão Geral
O Codeprism é uma skill que permite que agentes de codificação de IA gerenciem de forma eficiente o contexto do projeto, mantendo tudo localmente. Em vez de carregar arquivos completos no contexto (o que pode ser caro e ineficiente), ele mapeia a estrutura do projeto, permite que o usuário selecione fatias precisas de código e recupera apenas o necessário quando solicitado.
Como Funciona
- Mapear (map): A skill primeiro analisa a estrutura do projeto e cria um índice dos arquivos e diretórios relevantes.
- Fatiar (slice): Com base no índice, o usuário ou agente pode selecionar partes específicas do código (fatias) para incluir no contexto.
- Recuperar (retrieve): Quando uma consulta é feita, a skill recupera exatamente as fatias de código que correspondem à consulta, minimizando o ruído.
Plataformas Suportadas
- Claude Code: Totalmente integrado.
- Cursor: Suporte via extensões.
- Codex: Compatível com ajustes.
Requisitos
- Node.js 18+.
- Um projeto Git inicializado.
- Acesso ao terminal para comandos iniciais.
Instalação
npm install -g @kunolabs/codeprism
# ou
npx kunolabs/codeprism init
Comandos
| Comando | Descrição |
|---|---|
codeprism map | Mapeia a estrutura do projeto atual |
codeprism slice <caminho> | Cria uma fatia do arquivo ou diretório especificado |
codeprism retrieve <consulta> | Recupera fatias relevantes para a consulta |
codeprism status | Exibe o estado atual do índice e das fatias |
Exemplo de Uso
# Mapear o projeto
codeprism map
# Fatiar um arquivo específico
codeprism slice src/utils/helpers.ts
# Recuperar fatias relacionadas a "autenticação"
codeprism retrieve autenticação
Variáveis de Ambiente
COPRISM_CACHE_DIR: Diretório para cache local (padrão:~/.codeprism/cache).COPRISM_LOG_LEVEL: Nível de log (debug,info,warn,error).
Notas Importantes
- Todo o processamento é feito localmente. Nenhum dado sai da sua máquina.
- As fatias são armazenadas em formato JSON no diretório de cache.
- A skill respeita
.gitignore: arquivos ignorados não são mapeados.
Contribuição
Veja o repositório kunolabs/codeprism para contribuições e relatórios de bugs.