O que é Kensaku?
Kensaku é um aplicativo de busca para desktop, de código aberto, para Windows, macOS e Linux. Ele indexa nomes de arquivos, o texto dentro de PDFs, arquivos do Office, EPUBs, e-mails e mais de 50 formatos de código e dados, o texto lido por OCR em capturas de tela e um pequeno modelo de embeddings para busca por significado. O binário kensaku-cli roda um servidor MCP via stdio que busca no mesmo índice local e também pode servi-lo por HTTP em loopback.
O repositório, do usuário do GitHub yjid, foi criado em 24 de outubro de 2026 e tinha cerca de 1.645 estrelas e 107 forks em 11 de novembro. Tem licença MIT e é escrito em Rust com uma interface Tauri. A versão 1.0.17, lançada em 9 de novembro de 2026, é uma versão de segurança que corrigiu cinco problemas relatados de forma privada, três deles classificados como altos.
Como instalar Kensaku
kensaku-cli mcp (kensaku-cli ships with each GitHub release)Kensaku vale a pena?
Kensaku dá a um agente algo que a maioria dos servidores de arquivos não oferece: buscar pelo que um arquivo diz, e não pelo nome dele, em documentos, código e no texto dentro de capturas de tela, a partir de um índice que um aplicativo de desktop já mantém atualizado. As ferramentas MCP são search, regex_search, find_symbol para definições tree-sitter em Rust, Python, JavaScript e TypeScript, read_snippet, health_check e index_state. Todas são somente leitura. Existe uma ferramenta reindex, mas ela fica oculta e desligada a menos que você defina mcp_allow_reindex na configuração, e nunca roda por HTTP.
As respostas são feitas para caber numa janela de contexto. Os trechos de busca são limitados a 100 caracteres, as páginas trazem 10 resultados por padrão e param em 50, e read_snippet devolve no máximo 1.024 tokens centrados na primeira ocorrência, em vez de um arquivo inteiro. Segundo os benchmarks do projeto, uma busca por nome em 100.000 arquivos leva em média 18 ms no Windows 11 com as threads padrão, e os metadados desses arquivos ocupam 12,2 MB. A linguagem de consulta (type:pdf, modified:7d, re:"...") passa direto pela ferramenta search.
O porém: a idade. O repositório foi criado em 24 de outubro de 2026, e a 1.0.17 de 9 de novembro corrigiu cinco avisos, entre eles restrições de raiz do agente que podiam ser contornadas por escopos de busca e find_symbol, um read_snippet que lia arquivos excluídos e nunca indexados e um atualizador do Linux que aceitava um diretório de staging controlado por um atacante. Corrigir rápido e publicar os avisos é um bom sinal; encontrar três falhas graves na fronteira do agente nas duas primeiras semanas mostra que essa fronteira ainda está sendo definida. Os builds de release não são assinados no macOS nem no Windows.
A exposição a prompt injection é o próprio índice. Qualquer texto numa pasta monitorada, incluindo PDFs baixados e capturas de tela de outras pessoas, pode voltar ao agente num trecho. A documentação diz que o conteúdo dos arquivos é devolvido como dados, nunca como instruções, mas isso é um rótulo na saída, não um filtro ao qual o modelo esteja preso. Arquivos de credenciais como .pem e .key, pastas como .ssh e .aws e arquivos .env são bloqueados por padrão, e agent_scoped_roots restringe o que um agente vê a pastas escolhidas; quem apontar um agente para um diretório pessoal deve configurá-lo.
Onde ele se destaca
Um desenvolvedor backend investigando uma falha de deploy da semana passada
Encontrar a linha de log e a captura de tela do erro sem lembrar nomes de arquivos
Peça ao agente para buscar o texto do erro com modified:7d; o Kensaku devolve ocorrências em arquivos de log e capturas lidas por OCR, com caminhos, e read_snippet traz as linhas ao redor. Gratuito; o aplicativo de desktop já construiu o índice.
Uma consultora com anos de PDFs e apresentações de clientes no notebook
Reunir todas as propostas que mencionam um modelo de preços específico
Defina agent_scoped_roots para a pasta de clientes e peça ao agente uma busca de conteúdo filtrada por type:pdf, resumindo os resultados a partir dos trechos. Nada sai da máquina além do que o próprio provedor de modelo do agente vê.
Um engenheiro novo num repositório grande e com várias linguagens
Localizar onde uma função ou struct é definida em vários projetos
Use find_symbol com filtro de linguagem para obter caminho, intervalo de linhas e assinatura, e abra só esses arquivos. Mais rápido que um grep completo num diretório pessoal, com limite de 200 arquivos analisados por chamada.
Antes de decidir
- Configuração
- Baixe o pacote do aplicativo para sua plataforma nas releases do GitHub (sem assinatura, então espere um aviso do SmartScreen ou do Gatekeeper), escolha pastas e exclusões na primeira execução e aponte um cliente MCP para kensaku-cli mcp. Em Settings, Agents, o app pode escrever a entrada para Claude Desktop, Claude Code e Cursor com um backup .bak.
- Integrações
- Seis ferramentas visíveis: search, regex_search, find_symbol, read_snippet, health_check e index_state, mais um reindex opcional. Stdio por padrão; kensaku-cli serve adiciona MCP Streamable HTTP na porta de loopback 8765 com token bearer.
- Dados e privacidade
- Lê o índice das pastas que você escolher, com nomes de arquivos e texto extraído; as ferramentas não conseguem alterar arquivos. Sem telemetria; o tráfego de saída é uma verificação de atualização e downloads de pacotes de modelo ou OCR. O modo HTTP abre uma porta de loopback com um token guardado em <config>/http.token. Texto indexado é entrada não confiável para o agente. Cinco avisos (três altos) foram corrigidos na 1.0.17.
- Custo em escala
- Gratuito. O custo é local: um primeiro índice de cerca de 101.000 arquivos variados levou 184 s com pico de 183 MB na execução de referência do projeto no Linux.
- Limites
- Cerca de 16 issues abertas. O modo exaustivo para em 10.000 resultados por varredura; find_symbol cobre quatro linguagens; scans JPEG 2000, fax e JBIG2 não são decodificados; a busca visual é um download beta fora dos resultados. O Windows é o que recebe mais testes reais.
O que é bom
- Busca em texto de documentos, OCR e significado, não só em nomes
- Ferramentas somente leitura; reindex desligado por padrão
- Trechos com orçamento de tokens e paginação
- Sem conta, telemetria ou busca na nuvem
O que não é
- Cinco avisos de segurança corrigidos nas primeiras semanas
- Builds sem assinatura no macOS e no Windows
- Texto indexado pode levar prompt injection ao agente
- Busca visual ainda não faz parte dos resultados
Ideal para
Desenvolvedores e profissionais do conhecimento que querem que Claude ou Cursor encontrem arquivos na própria máquina pelo conteúdo e que vão restringir o agente a pastas escolhidas.
Alternativas ao Kensaku
Kensaku: perguntas frequentes
- Kensaku vale a pena?
- Um jeito rápido de deixar um agente encontrar pelo conteúdo o que está no seu próprio disco, vindo de um projeto com apenas três semanas cuja primeira versão de segurança acabou de sair. Damos nota 3.7 de 5.
- Quanto custa Kensaku?
- Gratuito e de código aberto (MIT). Sem plano pago, conta ou serviço em nuvem.
- Quais são as desvantagens de Kensaku?
- Cinco avisos de segurança corrigidos nas primeiras semanas; builds sem assinatura no macOS e no Windows; texto indexado pode levar prompt injection ao agente; busca visual ainda não faz parte dos resultados.
- Para quem Kensaku é indicado?
- Desenvolvedores e profissionais do conhecimento que querem que Claude ou Cursor encontrem arquivos na própria máquina pelo conteúdo e que vão restringir o agente a pastas escolhidas.
- Quanto custa Kensaku para uma equipe ou em produção?
- Gratuito. O custo é local: um primeiro índice de cerca de 101.000 arquivos variados levou 184 s com pico de 183 MB na execução de referência do projeto no Linux.
- Kensaku é seguro para dados da empresa?
- Lê o índice das pastas que você escolher, com nomes de arquivos e texto extraído; as ferramentas não conseguem alterar arquivos. Sem telemetria; o tráfego de saída é uma verificação de atualização e downloads de pacotes de modelo ou OCR. O modo HTTP abre uma porta de loopback com um token guardado em <config>/http.token. Texto indexado é entrada não confiável para o agente. Cinco avisos (três altos) foram corrigidos na 1.0.17.
- Quais são as melhores alternativas ao Kensaku?
- As alternativas mais próximas que analisamos são Filesystem (reference server), Zvec-Grep (zg) e Paperless-NGX MCP Server.
Respostas verificadas em 11 de nov. de 2026.