MESH
Terminal  ·  IDE  ·  MCP  ·  API

A terminal-first code-context platform for AI-assisted engineering. Repository capsules, verified change workflows, runtime diagnostics, issue automation, workspace memory, and MCP for the agents you already use.

$ npm i -g @trymesh/cli click to copy
↓ See how it works
scroll
Inside the Capsule Engine

87,030 tokens of source.
3,347 tokens to your model.

A live trace of one Mesh run. Every file in your workspace, parsed, distilled, and packed into a budget your model can actually fit — without dropping a single one.

247 Files Extracted
100% Structure Retained
3.9× Context Density
Capsule Playground
Raw Source Code 0 tokens
Distilled Capsule 0 tokens
Files: 1
CDT: Active
S0 Context: Live
4.2× Compression
The Platform

Four surfaces.
One engine.

Start with the CLI for verified execution. Add MCP to give Claude Code, Cursor, Windsurf, and VS Code the same structured workspace tools. IDE and API are preview surfaces around the shared runtime.

01 Terminal
The CLI.
mesh
mesh › /start
→ doctor · index · repo briefing
mesh › /change fix broken auth
✓ patch + verification report

Install globally. Runs in any terminal. /start, /change, /autopilot, timelines, proof bundles, and local voice.

Install now →
02 Desktop IDE
The IDE.
mesh workspace - billing-api
EXPLORER
src/
auth.ts
session.ts
billing.ts
dashboard.tsx
session.ts 247 files indexed
12 export async function refreshSession(ctx) {
13   const token = await ctx.cookies.get('mesh.sid')
14   if (isExpired(token)) return redirect('/login')
15   return resumeWorkspace(ctx)
16 }
Mesh - capsule context attached - suggested fix ready

A desktop-first preview workbench with Monaco, file tree, terminal SSE, git APIs, and a runtime bridge currently in progress.

IDE docs →
03 MCP For Agents
Agent Native.
claude code + mesh mcp
// Claude Code / Cursor using Mesh MCP
claude » investigate the session timeout bug
 
tool mesh_search("session expiry")
→ src/session/store.ts:44
→ src/auth/middleware.ts:88
 
tool mesh_read_targeted(…)
→ timeline check (proof bundle ready)
→ agent edits only the relevant span

Mesh plugs into Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code via @trymesh/mcp (~25 mesh_* tools). The full 100+ workspace.* surface stays in the CLI.

MCP docs →
04 Gateway API
The API.
gateway · coming soon
REQUEST · POST /agent
task: "review PR #204"
workspace: "org/api"
tools: ["github"]
model: "google/gemini-2.5-flash"
RESPONSE · 200 OK
result: "2 files need changes"
tokens_used: 1204
tokens_saved: 8621
sources: 2 spans

Embed Mesh-style capsule search, recovery, and agent workflows through a preview HTTP surface. Use CLI/MCP for production execution today.

API docs →
Explore
Go
deeper.
About

What Mesh is, product surfaces, team, Google Cloud plans, and benchmarks — for reviewers and developers.

Quickstart

Install the CLI, run /start, then ship one narrow verified change with /change.

Benchmarks

100% NIAH recall. 5× token efficiency. 0% hallucination. Real LLM benchmark data.

Operator FAQ
What Mesh
actually does.

Mesh is not just another chat window. It is a code-context engine that turns a real workspace into capsules, exact spans, timelines, and agent-ready commands.

/startgolden path /changeverified edit 100+CLI tools
How is Mesh different from a normal coding chat?+

Mesh builds a structural capsule of the repo before the model answers. The agent sees symbols, signatures, relationships, summaries, and can recover exact file spans instead of guessing from pasted raw source.

What is inside a capsule?+

Capsules combine low-tier file summaries, medium-tier AST structure, and high-tier semantic context for files that matter. Smart cache invalidation keeps unchanged files from being re-indexed every run.

Does Mesh replace Claude Code, Codex, Cursor, or Windsurf?+

No. Mesh can be the terminal agent, but it also exposes the same workspace intelligence through MCP and API surfaces, so existing coding assistants can ask Mesh for structured context.

What are timelines and fix racing?+

Risky changes can run in isolated worktree-backed timelines. Mesh can test alternate fixes, compare results, and only promote the version that passes the chosen verification command.

Can Mesh help with runtime bugs?+

Yes. Runtime tracing workflows start commands under observation, capture failures, stack traces, and runtime evidence, then connect the symptom back to code paths.

Can I use it hands-free?+

Voice mode uses local speech-to-text and native system speech output, so you can dictate architecture thoughts or coding requests without sending audio through a cloud transcription API.

Can data stay local?+

Indexing, capsules, timelines, and company memory are local-first. Model calls go through the selected Mesh gateway, NVIDIA, Google, or BYOK route, and Mesh sends only the prompt/context needed for the active workflow.

Where should a new user start?+

Install the CLI, run mesh in a repo, then type /start. After the briefing, use /change <small goal> for one verified patch. Add MCP once you want Claude Code, Cursor, Windsurf, or VS Code to use the same Mesh tools.