What is Mantic.sh?
Mantic.sh is a code search tool built for coding agents. Instead of searching file contents like grep, it ranks files mostly from their paths and names: a query such as "router server" scores router-server.ts highly because the words appear in sequence in the path, and "ScriptController" matches script_controller.cc by splitting CamelCase. It lists files with git ls-files, scores them, and returns JSON with confidence scores and token estimates.
On top of that it has go-to-definition and find-references through Tree-sitter for TypeScript, JavaScript and Python, an optional --semantic mode that reranks with the all-MiniLM-L6-v2 embedding model run locally, an impact view of a file's dependents, and sessions that boost files already viewed. It runs as a CLI (npx mantic.sh) or as a stdio MCP server for Claude Desktop, Cursor and VS Code.
The project is TypeScript from the GitHub account marcoaapfortes, created in January 2026, with about 553 stars. It moved from AGPL-3.0 to MIT with v1.0.26 on 13 July 2026, which is also its latest release and last commit.
Is Mantic.sh worth it?
Mantic bets that a repository's folder and file names already say where the code is, and for well-organised projects the bet often pays. It needs no index build and no model for its default mode, sends nothing off the machine, and answers in under two seconds even on Chromium's 481,000 files by the README's own timings. For an agent that would otherwise run several greps and open the wrong files, one ranked list is a cheaper first step.
The evidence is thin and self-graded. The README awards the tool "4/5" in its own summary, claims token savings of "up to 63%" without a published method, and its benchmark table compares speed, where ripgrep wins every row: 0.121 seconds against 0.288 on cal.com, 0.022 against 0.550 on TensorFlow. The relevance examples are four hand-picked queries. Uptake is small too: the mantic.sh npm package recorded 12 downloads in the week to 17 November 2026.
The catch: ranking by structure fails exactly where search matters most, in code whose location does not describe it. A billing rule inside utils/helpers.ts will not rank for "billing" unless the --semantic reranker or the function-name scan rescues it. Development has also paused; the last release and commit were on 13 July 2026, and the 1.0.25 changelog lists a command-injection fix in the VS Code extension, so older extension installs should be updated.
Against the site's other agent search tools, Mantic is the lightest and the shallowest. ast-grep matches syntax trees exhaustively and suits rewrites; grepai and Repowise build indexes that understand content; jevgrep asks a model about each candidate and publishes cost measurements, at the price of sending code to a provider. Our take: Mantic is a reasonable free first pass for a tidy TypeScript or Python monorepo, and not a substitute for content search on a legacy codebase.
Where it earns its place
A developer on a Next.js monorepo of about 25,000 files using Cursor
Stop the agent opening a dozen wrong files before it finds the route handler
Add the MCP server with the one-click Cursor link and paste AGENT_RULES.md into the rules so the agent calls search_files first. The README timed a query on next.js at 0.440 seconds; there is no cost beyond local CPU.
A reviewer at a 10-person product team
See what else might break before approving a change to payment code
Run mantic "payment processing" --impact to list dependents of the matching files, then read the ones that matter. The dependency graph covers JavaScript, TypeScript and Python imports.
A contractor working in a client repo under NDA
Search by meaning without sending code to an embedding API
Use --semantic, which downloads all-MiniLM-L6-v2 once and reranks on the laptop through transformers.js. Learned query patterns stay in .mantic/search-patterns.json unless you commit them.
Before you commit
- Setup
- npx mantic.sh@latest "your query" in a git repository works with no config; the MCP server is npx -y mantic.sh@latest server in your client's config.
- Integrations
- stdio MCP server with tools including search_files, get_definition, find_references, get_context and session tools; one-click installs for Cursor and VS Code; a VS Code extension; an AGENT_RULES.md to paste into agent rules.
- Data and privacy
- Local only; the README states zero data egress, and the semantic model runs through transformers.js on your machine. Learned patterns are written to .mantic/search-patterns.json in the repo. MIT from v1.0.26; earlier releases stay AGPL-3.0.
- Limits
- Structure-first ranking misses code in vaguely named files; MANTIC_TIMEOUT defaults to 30,000 ms; Tree-sitter features cover TS, JS and Python only; last release 13 July 2026.
What’s good
- Runs locally with no index build and no data leaving the machine
- CamelCase and path-sequence matching find files by intent
- Tree-sitter go-to-definition and references for TS, JS and Python
- MIT licence since v1.0.26, with one-line MCP setup
What’s not
- Ranks mostly on paths and names, so badly named code is missed
- Benchmarks and the 63% token claim are self-reported
- No release or commit since 13 July 2026
- Small user base: 12 npm downloads in a recent week
Best for
Developers whose agents work in well-structured TypeScript or Python repos and who want a free, local first-pass file ranker.
Mantic.sh alternatives
Mantic.sh: common questions
- Is Mantic.sh worth it?
- Mantic is a quick, private way to point an agent at the right file when your paths are well named, and little help when they are not. We rate it 3.3 out of 5.
- How much does Mantic.sh cost?
- Free and open source (MIT from v1.0.26; earlier releases AGPL-3.0). Runs locally with no paid tier.
- What are the downsides of Mantic.sh?
- Ranks mostly on paths and names, so badly named code is missed; benchmarks and the 63% token claim are self-reported; no release or commit since 13 July 2026; small user base: 12 npm downloads in a recent week.
- Who is Mantic.sh best for?
- Developers whose agents work in well-structured TypeScript or Python repos and who want a free, local first-pass file ranker.
- Is Mantic.sh safe for company data?
- Local only; the README states zero data egress, and the semantic model runs through transformers.js on your machine. Learned patterns are written to .mantic/search-patterns.json in the repo. MIT from v1.0.26; earlier releases stay AGPL-3.0.
- What are the best Mantic.sh alternatives?
- The closest alternatives we have reviewed are ast-grep, grepai, jevgrep and Repowise.
Answers checked Nov 18, 2026.