NeuroMesh
How does nature pack two metres of DNA into a nucleus without deleting a single letter? Not by throwing genes away — by folding. NeuroMesh does the same to your repository: a neural graph in RAM, reversible one-line folds, and an evidence packet instead of three thousand-line files dumped into Cursor or Claude.
Local-first MCP · Cursor · Codex · OpenCode · MiMo CLI · Antigravity · VS Code · Claude · Kilo · Trae · Windsurf · Zed
The pain
You ask a simple question in a large project. The editor copies two or three thousand-line files and ships them to the model.
Tokens you never needed
Dollar cost on every turn — paying for helpers you will never touch.
Seconds of fake loading
While the window fills with unrelated bodies and private utilities.
Lost in the middle
The model drowns in unrelated code and invents bugs that don't exist.
| Approach | What goes wrong |
|---|---|
| Vector RAG | Chunks smash functions. The shape of the code disappears. |
| "Just attach the files" | The model sees everything and understands nothing. |
| A static code graph | Better map — then it still pastes full files into the prompt. |
| NeuroMesh | Route first, then fold. The graph finds the path. The packet is what the model reads. |
Don't delete. Fold.
Nature does not delete DNA to fit a nucleus. It supercoils. NeuroMesh treats the syntax tree like a genetic strand in RAM.
Exons — expressed
Functions you need stay fully visible — real body, real lines.
Introns — folded
Everything else collapses to a one-line reversible marker with a fold ID.
Wake on demand
neuromesh_expand_fold unsplices from memory. No disk grep.
Inspired by living systems
DNA supercoiling
Fold unused bodies; keep the map of the file.
Physarum (slime mold)
Grow the cheapest path between seeds — not the whole neighborhood.
Synapses & STDP
Paths you actually edited get stronger next time.
Cell membrane
Tight by default; auth / payment tasks open the membrane.
Mycelium
Warm the next hop before the second tool call.
Neural mesh
Files, functions, Imports, Calls — a nervous system, not a bag of strings.
3D Neural Galaxy
neuromesh monitor is the live mesh: subsystems as a constellation,
then the file graph, then the symbols inside a module.
Default URL: http://127.0.0.1:8765
· Port: neuromesh port
How a turn actually goes
Route first, then fold. Seeds are never truncated to fake a small packet.
Prompt
Read the task exactly as written — intent is not lowercased into mush.
max_savings
Tiny, obvious edits
balanced
Everyday development
max_quality
Refactors, auth, critical paths
Smarter every turn
NeuroMesh doesn't forget what worked. Every successful edit is experience —
neuromesh_record_feedback strengthens the synapses on the path you actually used.
Next packet, the mesh routes faster and closer to gold.
Experience from edits
Only paths the agent actually edited get credit. No fake links from guessing — unique resolve keeps the graph honest.
Pheromone edges
Co-edited files share stronger tubes. Physarum prefers reinforced routes — like slime mold remembering where food was.
Mycelial memory
Hyphal prefetch warms the next hop in RAM. The mesh doesn't just learn routes — it pre-warms what you'll expand next.
record_feedback and the next packet starts from zero plasticity.
What we actually measured
Savings are per task, after folding. Re-run: neuromesh eval
Release 2026-08-28 · 554,554 workspace tokens
| Task | Mode | WS tok | Selected | Packet | vs WS | Recall | Grep | ms |
|---|---|---|---|---|---|---|---|---|
handle_tool_call_intent | balanced | 554,554 | 63,462 | 15,900 | 97.1% | 1.00 | 0 | 33 |
physarum_usage | balanced | 554,554 | 18,631 | 3,945 | 99.3% | 1.00 | 0 | 17 |
Install
One command. Then neuromesh doctor and neuromesh connect.
curl -fsSL https://raw.githubusercontent.com/pinoox/neuromesh/main/install.sh | bash
irm https://raw.githubusercontent.com/pinoox/neuromesh/main/install.ps1 | iex
git clone https://github.com/pinoox/neuromesh.git cd neuromesh cargo build --release --bin neuromesh
cargo install --git https://github.com/pinoox/neuromesh.git neuromesh-cli --bin neuromesh
neuromesh doctor neuromesh connect # write MCP configs for this repo
Connect
Native MCP stdio — Cursor, Claude, Codex, Antigravity, VS Code, Kilo Code, Trae, and more.
neuromesh connect writes an absolute binary path so the agent doesn't need NeuroMesh on PATH.
{
"mcpServers": {
"neuromesh": {
"command": "neuromesh",
"args": ["mcp"]
}
}
}
.cursor/mcp.json.vscode/mcp.jsonopencode.json.mimo-code.json.codex/config.toml.agents/mcp_config.json.kilo/kilo.jsonc.trae/mcp.json.minimax/mcp.json.mcp.json~/.gemini/settings.jsonRun neuromesh connect to write configs for installed apps, or neuromesh connect --print for snippets.
Tools
Tell the agent: get context → expand fold if needed → trace → record feedback.
Rust, TypeScript, Python, Go, Java, Kotlin, PHP, C#, Dart, Swift, Ruby — tree-sitter queries. Framework overlays for Laravel, Django, Next, Nuxt, Spring, Android, and 30+ more.