rawq: Ferramenta CLI Local para Busca Semântica de Código por Agentes de IA

O que o rawq faz

rawq é uma ferramenta CLI local que ajuda agentes de IA a encontrar código relevante sem ler arquivos inteiros. Ele usa busca semântica para guiar agentes de IA para partes específicas do código em vez de arquivos completos, permitindo que eles usem leitura/grep nos arquivos certos. A ferramenta não é RAG nem um substituto para leitura/grep.

Implementação técnica

rawq usa um modelo local de 33MB por padrão que funciona via ONNX runtime para busca semântica, combinado com busca lexical BM25 via tantivy. A ferramenta suporta fragmentação de código com tree sitter para 16 linguagens e funciona em qualquer GPU graças ao ONNX com DirectML, CUDA ou CoreML, com fallback automático para CPU.

Desempenho e recursos

Em testes, agentes de IA que usaram rawq consumiram 4 vezes menos tokens e completaram tarefas 2 vezes mais rápido em comparação com ferramentas cegas de leitura/grep. rawq também tem um comando map que mostra a estrutura de uma base de código.

Detalhes de desenvolvimento

A ferramenta é escrita em Rust, totalmente de código aberto e lançada sob licença MIT. Está disponível no GitHub em https://github.com/auyelbekov/rawq.