O que é Mantic.sh?
O Mantic.sh é uma ferramenta de busca de código feita para agentes de programação. Em vez de procurar no conteúdo dos arquivos como o grep, ele os ordena principalmente pelos caminhos e nomes: uma consulta como "router server" dá nota alta a router-server.ts porque as palavras aparecem em sequência no caminho, e "ScriptController" encontra script_controller.cc ao separar o CamelCase. Ele lista os arquivos com git ls-files, pontua e devolve JSON com notas de confiança e estimativas de tokens.
Além disso, tem ir para a definição e achar referências via Tree-sitter para TypeScript, JavaScript e Python, um modo opcional --semantic que reordena com o modelo de embeddings all-MiniLM-L6-v2 rodando localmente, uma visão de impacto com os dependentes de um arquivo e sessões que priorizam arquivos já vistos. Roda como CLI (npx mantic.sh) ou como servidor MCP stdio para Claude Desktop, Cursor e VS Code.
O projeto é TypeScript da conta do GitHub marcoaapfortes, criado em janeiro de 2026, com cerca de 553 estrelas. Passou de AGPL-3.0 para MIT com a v1.0.26 em 13 de julho de 2026, que é também sua última versão e seu último commit.
Mantic.sh vale a pena?
O Mantic aposta que os nomes de pastas e arquivos de um repositório já dizem onde o código está, e em projetos bem organizados a aposta costuma dar certo. No modo padrão ele não precisa montar índice nem usar modelo, não manda nada para fora da máquina e responde em menos de dois segundos até nos 481.000 arquivos do Chromium, pelos tempos do próprio README. Para um agente que, de outro jeito, rodaria vários grep e abriria os arquivos errados, uma lista ordenada é um primeiro passo mais barato.
As evidências são escassas e autoavaliadas. O README se dá "4/5" no próprio resumo, promete economia de tokens "de até 63%" sem método publicado, e sua tabela de benchmarks compara velocidade, em que o ripgrep vence todas as linhas: 0,121 segundo contra 0,288 no cal.com, 0,022 contra 0,550 no TensorFlow. Os exemplos de relevância são quatro consultas escolhidas a dedo. A adoção também é pequena: o pacote npm mantic.sh registrou 12 downloads na semana até 17 de novembro de 2026.
O porém: ordenar pela estrutura falha justamente onde a busca mais importa, em código cuja localização não o descreve. Uma regra de cobrança dentro de utils/helpers.ts não vai aparecer para "billing" a menos que o reordenador --semantic ou a varredura de nomes de funções a resgate. O desenvolvimento também parou; a última versão e o último commit são de 13 de julho de 2026, e o changelog da 1.0.25 cita a correção de uma injeção de comando na extensão do VS Code, então instalações antigas da extensão devem ser atualizadas.
Frente às outras ferramentas de busca para agentes do site, o Mantic é a mais leve e a mais rasa. O ast-grep compara árvores sintáticas de forma exaustiva e serve para reescritas; o grepai e o Repowise montam índices que entendem o conteúdo; o jevgrep consulta um modelo sobre cada candidato e publica medições de custo, ao preço de enviar código a um provedor. Nossa opinião: o Mantic é uma primeira passada gratuita razoável para um monorepo organizado de TypeScript ou Python, e não substitui a busca por conteúdo num código legado.
Onde ele se destaca
Um desenvolvedor num monorepo Next.js de cerca de 25.000 arquivos que usa o Cursor
Fazer o agente parar de abrir uma dúzia de arquivos errados antes de achar o handler de rota
Adicione o servidor MCP pelo link de um clique do Cursor e cole o AGENT_RULES.md nas regras para o agente chamar search_files primeiro. O README mediu uma consulta no next.js em 0,440 segundo; não há custo além da CPU local.
Um revisor num time de produto de 10 pessoas
Ver o que mais pode quebrar antes de aprovar uma mudança no código de pagamentos
Rode mantic "payment processing" --impact para listar os dependentes dos arquivos encontrados e leia os que importam. O grafo de dependências cobre imports de JavaScript, TypeScript e Python.
Um prestador de serviço trabalhando no repositório de um cliente sob NDA
Buscar por significado sem enviar código a uma API de embeddings
Use --semantic, que baixa o all-MiniLM-L6-v2 uma vez e reordena no notebook via transformers.js. Os padrões de consulta aprendidos ficam em .mantic/search-patterns.json, a menos que você os faça commit.
Antes de decidir
- Configuração
- npx mantic.sh@latest "sua consulta" funciona num repositório git sem configuração; o servidor MCP é npx -y mantic.sh@latest server na configuração do seu cliente.
- Integrações
- Servidor MCP stdio com ferramentas como search_files, get_definition, find_references, get_context e ferramentas de sessão; instalação em um clique para Cursor e VS Code; uma extensão do VS Code; um AGENT_RULES.md para colar nas regras do agente.
- Dados e privacidade
- Só local; o README declara zero saída de dados, e o modelo semântico roda via transformers.js na sua máquina. Os padrões aprendidos são gravados em .mantic/search-patterns.json no repositório. MIT a partir da v1.0.26; versões anteriores continuam AGPL-3.0.
- Limites
- A ordenação por estrutura perde código em arquivos com nomes vagos; MANTIC_TIMEOUT é 30.000 ms por padrão; os recursos de Tree-sitter cobrem só TS, JS e Python; última versão em 13 de julho de 2026.
O que é bom
- Roda localmente, sem montar índice e sem dados saindo da máquina
- Correspondência de CamelCase e de sequência de caminho acha arquivos pela intenção
- Definição e referências via Tree-sitter para TS, JS e Python
- Licença MIT desde a v1.0.26, com configuração MCP em uma linha
O que não é
- Ordena sobretudo por caminhos e nomes, então código mal nomeado escapa
- Benchmarks e o número de 63% de tokens são autodeclarados
- Nenhuma versão ou commit desde 13 de julho de 2026
- Base de usuários pequena: 12 downloads no npm numa semana recente
Ideal para
Desenvolvedores cujos agentes trabalham em repositórios TypeScript ou Python bem estruturados e que querem um primeiro filtro de arquivos gratuito e local.
Alternativas ao Mantic.sh
Mantic.sh: perguntas frequentes
- Mantic.sh vale a pena?
- O Mantic leva um agente ao arquivo certo de forma rápida e privada quando seus caminhos têm bons nomes, e ajuda pouco quando não têm. Damos nota 3.3 de 5.
- Quanto custa Mantic.sh?
- Gratuito e de código aberto (MIT a partir da v1.0.26; versões anteriores AGPL-3.0). Roda localmente, sem plano pago.
- Quais são as desvantagens de Mantic.sh?
- Ordena sobretudo por caminhos e nomes, então código mal nomeado escapa; benchmarks e o número de 63% de tokens são autodeclarados; nenhuma versão ou commit desde 13 de julho de 2026; base de usuários pequena: 12 downloads no npm numa semana recente.
- Para quem Mantic.sh é indicado?
- Desenvolvedores cujos agentes trabalham em repositórios TypeScript ou Python bem estruturados e que querem um primeiro filtro de arquivos gratuito e local.
- Mantic.sh é seguro para dados da empresa?
- Só local; o README declara zero saída de dados, e o modelo semântico roda via transformers.js na sua máquina. Os padrões aprendidos são gravados em .mantic/search-patterns.json no repositório. MIT a partir da v1.0.26; versões anteriores continuam AGPL-3.0.
- Quais são as melhores alternativas ao Mantic.sh?
- As alternativas mais próximas que analisamos são ast-grep, grepai, jevgrep e Repowise.
Respostas verificadas em 18 de nov. de 2026.