Pular para o conteúdo
ReviewRamble

A newsletter semanal

IA, analisada, na sua caixa de entrada.

  • Novas análises de ferramentas, modelos, servidores MCP e repositórios, com o veredicto logo no início
  • Preços e notas reconferidos quando algo muda
  • Novos artigos de análise assim que são publicados

Modelos, agentes, servidores MCP e as ferramentas que realmente valem seu tempo.

Um e-mail por semana. Cancele pelo link em qualquer edição. Como usamos seu e-mail

Mantic.sh

CLI local e servidor MCP que ordenam os arquivos de um repositório pelo caminho e pelo nome, para o agente saber quais abrir primeiro.

Análise de ReviewRamble editors · Atualizado

Ver no GitHub Código aberto

Compartilhe esta página:XLinkedInFacebookRedditWhatsAppE-mail

Nossa nota

3.3/5

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.

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.