O que codewalk faz?
Ferramenta de integração orientada por IA para repositórios de código — aponte para qualquer repositório e faça perguntas sobre o código. Usa parsing tree-sitter, RAG e LLMs locais.
Como funciona
- Aponte para o repositório: Forneça o caminho local ou URL do repositório que deseja explorar.
- Faça perguntas: Use linguagem natural para perguntar sobre estrutura, funções, dependências, padrões de design e muito mais.
- Receba respostas contextualizadas: A skill utiliza parsing tree-sitter para construir uma representação sintática do código e um mecanismo RAG para recuperar trechos relevantes. Finalmente, um LLM local gera respostas precisas e explicativas.
Plataformas suportadas
- Claude Code
- Cursor
- Codex
- Outros terminais/IDE com suporte a skills de IA
Dependências
- Node.js 18+
- tree-sitter CLI (opcional, para parsing otimizado)
- Acesso a LLM local (por exemplo, Ollama, llama.cpp)
Uso básico
# Exemplo de comando (assumindo integração com Claude Code)
npx gupta29470/codewalk /caminho/para/repo
Após iniciar, digite perguntas como:
- "Como é a estrutura de diretórios?"
- "Onde está definida a função principal?"
- "Quais são as principais dependências?"
- "Explique o fluxo de autenticação."
Configuração
Variáveis de ambiente:
CODEWALK_LLM_URL: URL do endpoint do LLM local (padrão:http://localhost:11434)CODEWALK_MODEL: Nome do modelo (padrão:codellama)CODEWALK_MAX_TOKENS: Máximo de tokens por resposta (padrão:4096)
Contribuição
Pull requests são bem-vindos! Veja CONTRIBUTING.md para detalhes.
Licença
MIT