Skip to content
Back to search

neuromesh

The Biomimetic Context Engine & Neural Runtime for AI Coding Assistants

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pinoox--neuromesh/badge.svg)](/listings/pinoox--neuromesh)

HTML

<a href="/listings/pinoox--neuromesh"><img src="/api/listings/pinoox--neuromesh/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

**Pre-built binary** (no Rust required). v0.9.11 defaults to **`engine: fast`** — instant graph index, no ONNX warm at startup.

**macOS / Linux**

curl -fsSL https://raw.githubusercontent.com/pinoox/neuromesh/main/install.sh | bash

**Windows (PowerShell)**

irm https://raw.githubusercontent.com/pinoox/neuromesh/main/install.ps1 | iex

Then from your **project root**:

neuromesh doctor          # verify binary and workspace
neuromesh connect         # write MCP configs (Cursor, VS Code, Claude, …)
neuromesh index           # build the graph (<30s typical)

Restart your IDE so MCP picks up the new server. Re-run the installer to **update** — then `neuromesh -V` should show **v0.9.11**.

| Platform | Binary | | ------------- | ------------------------------------------------- | | macOS / Linux | `~/.local/bin/neuromesh` | | Windows | `%LOCALAPPDATA%\Programs\neuromesh\neuromesh.exe` |

Hybrid/deep embeddings (`neuromesh install embed minilm`), CBM proxy, monitor port: [docs/configuration.md](docs/configuration.md).

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 252 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # NeuroMesh
  2. ### Ship less context. Ship the right code.
  3. Local-first [MCP](https://modelcontextprotocol.io/) context engine for **Cursor**, **VS Code**, **Claude**, **Codex**, and every MCP client. NeuroMesh indexes your repo into a graph, routes your prompt to the right symbols, and sends a **folded evidence packet** — not thousand-line file dumps.
  4. ![Release](https://img.shields.io/github/v/release/pinoox/neuromesh?style=flat-square&color=22c55e)
  5. ![Rust](https://img.shields.io/badge/Rust-1.80%2B-orange.svg?style=flat-square&logo=rust)
  6. ![CI](https://github.com/pinoox/neuromesh/actions/workflows/ci.yml/badge.svg)
  7. ![MCP](https://img.shields.io/badge/MCP-stdio-5b21b6.svg?style=flat-square)
  8. ![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)
  9. Cursor · VS Code · Claude · Codex · OpenCode · MiMo CLI · Antigravity · Kilo · Trae · Windsurf · Zed
  10. [The pain](#the-pain) · [Fold](#dont-delete-fold) · [Galaxy](#3d-neural-galaxy) · [Measured](#what-we-actually-measured) · [Install](#install) · [Connect](#connect) · [Docs](docs/README.md) · [Site](https://pinoox.github.io/neuromesh/)
  11. ---
  12. ## The pain
  13. You ask a simple question in a large project. The editor copies two or three **thousand-line files** and ships them to the model.
  14. What you pay for:
  15. 1. **Tokens you never needed** — dollar cost on every turn
  16. 2. **Seconds of fake loading** while the window fills with helpers you will not touch
  17. 3. **Lost in the middle** — the model drowns in unrelated bodies and invents bugs
  18. Today’s workarounds all leak in a different place:
  19. | Approach | What goes wrong |
  20. | ----------------------- | ------------------------------------------------------------------- |
  21. | Vector RAG | Chunks smash functions. The shape of the code disappears. |
  22. | “Just attach the files” | The model sees everything and understands nothing. |
  23. | A static code graph | Better *map* — then it still pastes **full files** into the prompt. |
  24. NeuroMesh is the missing step: **route first, then fold.** The graph is for finding the path. The packet is what the model actually reads.
  25. ---
  26. ## Don’t delete. Fold.
  27. ### Don’t delete the extra code. Fold it.
  28. How does nature pack two metres of DNA into a nucleus without deleting a single letter?
  29. Not by throwing genes away — by **folding**.
  30. Nature does not delete DNA to fit a nucleus. It **supercoils**.
  31. NeuroMesh treats the syntax tree like a genetic strand in RAM:
  32. - Functions you need stay **expressed** (exons) — real body, real lines
  33. - The rest collapse to a **one-line reversible intron**:
  34. ```c
  35. /* [neuromesh:fold:fold_unused_helper_1 | 12 lines folded | fn unused_helper()] */
  36. ```
  37. The agent still sees the *shape* of the file — signatures, imports, neighbors — without paying for every private helper. When a folded body is required, `neuromesh_expand_fold` unsplices it from a registry in memory. Nothing was deleted. Nothing needs a second grep of the disk.
  38. > Structure stays. Tokens sleep. Wake a fold when you need it.
  39. ---
  40. ## Why it feels different
  41. | What you get | What it means for you |
  42. | ------------ | --------------------- |
  43. | **Smart folding** | Relevant functions stay open; everything else collapses to one-line markers you can expand on demand. |
  44. | **Shortest path routing** | Only the files your task needs — not the whole repo neighborhood. |
  45. | **Learns from your edits** | Call `record_feedback` after a good fix; similar tasks route faster next time. |
  46. | **Safety modes** | Balanced by default; auth and payment tasks automatically get more context. |
  47. | **Live code graph** | Your repo indexed in RAM — functions, imports, and calls, not shredded text chunks. |
  48. Curious about the biology metaphor? **[docs/nature.md](docs/nature.md)**
  49. ---
  50. ## Install
  51. **Pre-built binary** (no Rust required). v0.9.11 defaults to **`engine: fast`** — instant graph index, no ONNX warm at startup.
  52. **macOS / Linux**
  53. ```bash
  54. curl -fsSL https://raw.githubusercontent.com/pinoox/neuromesh/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 93 on GitHub
  55. ```
  56. **Windows (PowerShell)**
  57. ```powershell
  58. irm https://raw.githubusercontent.com/pinoox/neuromesh/main/install.ps1 | iex
  59. ```
  60. Then from your **project root**:
  61. ```bash
  62. neuromesh doctor # verify binary and workspace
  63. neuromesh connect # write MCP configs (Cursor, VS Code, Claude, …)
  64. neuromesh index # build the graph (<30s typical)
  65. ```
  66. Restart your IDE so MCP picks up the new server. Re-run the installer to **update** — then `neuromesh -V` should show **v0.9.11**.
  67. | Platform | Binary |
  68. | ------------- | ------------------------------------------------- |
  69. | macOS / Linux | `~/.local/bin/neuromesh` |
  70. | Windows | `%LOCALAPPDATA%\Programs\neuromesh\neuromesh.exe` |
  71. Hybrid/deep embeddings (`neuromesh install embed minilm`), CBM proxy, monitor port: [docs/configuration.md](docs/configuration.md).
  72. ---
  73. ## Connect
  74. NeuroMesh speaks **MCP over stdio** — what your IDE launches in the background.
  75. ```bash
  76. neuromesh connect --global --agent-rules # recommended once per machine
  77. ```
  78. That registers the server **and** copies the agent rule so the IDE actually calls NeuroMesh instead of raw `Read` / Grep.
  79. **Manual** (when `neuromesh` is on PATH) — paste into `~/.cursor/mcp.json`:
  80. ```json
  81. {
  82. "mcpServers": {
  83. "neuromesh": {
  84. "command": "neuromesh",
  85. "args": ["mcp"]
  86. }
  87. }
  88. }
  89. ```
  90. Per-client paths: [docs/mcp.md](docs/mcp.md).
  91. ---
  92. ## Agent loop
  93. Pass the **user task as written** — any language. Default **`engine: fast`**: graph + server-assisted concept expansion; no keyword tables.
  94. ```
  95. get_context_packet(query / task_description / prompt / task)
  96. → check coverage.claim and retrieval.resolution_tier
  97. → neuromesh_search_symbols or neuromesh_expand_gap if seeds missed
  98. → neuromesh_expand_fold when a folded body is required
  99. → neuromesh_trace for callers and blast radius
  100. → neuromesh_record_feedback after a successful edit
  101. ```
  102. Teach every IDE: [docs/agent-guide.md](docs/agent-guide.md) · Cursor template: [docs/agent-rule.mdc](docs/agent-rule.mdc).
  103. ---
  104. ## 3D Neural Galaxy
  105. `neuromesh monitor` is a live map of **your** project: packages at a glance, then the file graph, then symbols inside a module.
  106. ![Macro constellation of project subsystems in the 3D Neural Galaxy](docs/assets/galaxy-constellation.jpg)
  107. Constellation — packages and subsystems
  108. ![3D Neural Galaxy file graph with Physarum slime tubes](docs/assets/galaxy-3d.jpg)
  109. 3D galaxy — files and call/import links
  110. ![Module zoom showing Core files and function symbols](docs/assets/galaxy-module.jpg)
  111. Module zoom — files and symbols in one area of your codebase
  112. Default URL: [http://127.0.0.1:8765](http://127.0.0.1:8765) · `neuromesh monitor` · port: `neuromesh port`
  113. ---
  114. ## Tools (MCP)
  115. | Tool | Use |
  116. | --------------------------- | ------------------------------------ |
  117. | **`get_context_packet`** | Main entry — folded evidence packet |
  118. | `neuromesh_expand_fold` | Restore one folded body |
  119. | `neuromesh_search_symbols` | Ranked symbol search when seeds miss |
  120. | `neuromesh_trace` | Call / import chains |
  121. | `neuromesh_record_feedback` | Strengthen paths you actually edited |
  122. Full reference: [docs/mcp.md](docs/mcp.md).
  123. ---
  124. ## Everyday CLI
  125. ```bash
  126. neuromesh index # refresh graph after large changes
  127. neuromesh status # node / edge counts
  128. neuromesh monitor # 3D graph UI (see above)
  129. neuromesh doctor --engine # show retrieval preset
  130. neuromesh config engine hybrid # opt in to semantic search (needs embed install)
  131. ```
  132. Command reference: [docs/cli.md](docs/cli.md).
  133. ---
  134. ## Languages
  135. Rust, TypeScript, Python, Go, Java, Kotlin, PHP, C#, Dart, Swift, Ruby, and more via **tree-sitter**. Framework overlays for Laravel, Django, Next, Vue, Axum, Rails, Flutter, and others. Details: [docs/architecture.md](docs/architecture.md).
  136. ---
  137. ## What we actually measured
  138. Savings are **per task**, after folding — not a marketing average. Run `neuromesh eval` on your own repo to see your numbers.
  139. Example from a **650k-token monorepo** (release **v0.9.11**, default `engine: fast`):
  140. | Task (plain language) | Mode | Full repo | Before fold | Packet sent | Saved vs repo | Extra greps | ms |
  141. | :--- | :--- | ---: | ---: | ---: | ---: | ---: | ---: |
  142. | Fix the MCP tool handler | balanced | 650,859 | 72,428 | 17,389 | **97.3%** | **0** | 22 |
  143. | Trace graph routing code | balanced | 650,859 | 19,625 | 4,080 | **99.4%** | **0** | 12 |
  144. Index on that project: **340 files · 552 ms**. Methodology and multilingual holdout: [docs/quality.md](docs/quality.md).
  145. ---
  146. ## Documentation
  147. | Doc | Start here when you want to… |
  148. | -------------------------------------- | ------------------------------------------------ |
  149. | [Agent guide](docs/agent-guide.md) | Wire Cursor / VS Code / Claude to use NeuroMesh |
  150. | [MCP tools](docs/mcp.md) | See what each tool returns |
  151. | [CLI](docs/cli.md) | Commands for install, index, connect, monitor |
  152. | [Configuration](docs/configuration.md) | Switch engines, proxy, advanced tuning |
  153. | [Engines](docs/engines.md) | `fast` vs `hybrid` vs `deep` in one page |
  154. | [Docs index](docs/README.md) | Full map |
  155. | [Changelog](docs/CHANGELOG.md) | What changed in v0.9.11 |
  156. MIT · [LICENSE](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.