JSPM

Install

npm install -g @trymesh/cli
mesh login
mesh

mesh login opens a browser and hands the session back to your terminal. No API keys to copy, no config to edit. The shared Mesh gateway routes to Gemini 3.5 Flash by default; switch models with /model.

Requires Node.js 20 or newer.

Why Mesh

Mesh is built to prove its work, not perform it.

• Required-verify gate — every code change is followed by the exact test or typecheck command extracted from your package.json. If the command doesn't exit 0, the turn fails. No "tests pass" without a passing command.
• Anti-thrash hard-block — after three consecutive edits without a passing verify, write tools are rejected until the agent runs the verify and reports back. Stops the failure spiral that comes from blindly editing more.
• Adaptive scaffolding — every prompt is classified into a tier (trivial / small / complex). Trivial requests get a 900-byte system prompt and a four-step budget. Complex refactors get the full toolkit: workflow state machine, evidence ledger, full AST capsule with reverse-index, ensemble sampling. Same agent, right gear for the job.
• AST-precise capsules — for TypeScript and JavaScript, capsules are extracted with ts-morph (exports, generics, JSDoc, imports). Python, Rust, and Go use structured regex. Capsules are cached in .mesh/capsules/v1/ and invalidated via fs.watch on source changes.
• Task memory — fingerprints similar past tasks and surfaces which tools succeeded vs failed before, so the same trap doesn't get walked into twice.

Models

Default: Gemini 3.5 Flash. Switch any time with /model inside the CLI or --model <alias> from the shell.

All eleven are reachable through the Mesh gateway after mesh login. No personal API keys required.

Usage

# Interactive REPL in your project
mesh

# Sign in (opens a browser, hands the session back to the terminal)
mesh login

# Check who you're signed in as
mesh whoami

# One-shot turn from the shell
mesh "explain how the cost router decides between models"

# Force a model for this run only
mesh --model gemini-2.5-pro "refactor invoice.ts to use async/await"

# Inspect tier + capsule + system prompt without spending a token
mesh scaffold inspect "rename Status to JobState across all files"

# Health check
mesh doctor

Inside the REPL, /help lists every slash command. Highlights:

• /model — switch models from a picker
• /index — rebuild the workspace capsule cache
• /voice — enable voice input/output
• /usage — current session token + cost totals
• /dashboard — open the live supervision view in a browser
• /exit — close cleanly

Adaptive scaffolding

Mesh classifies every turn into one of three tiers and only spins up the machinery that tier needs.

Preview the tier decision for any prompt without spending a token:

mesh scaffold inspect "fix the null deref in parse.ts" --capsule --system-prompt

Force a tier for power-user sessions:

MESH_FORCE_TIER=complex mesh

Configuration

Mesh works out of the box. Override any of these with environment variables:

# Force a default model
export MESH_MODEL_ID=google/gemini-2.5-pro

# Force a scaffolding tier
export MESH_FORCE_TIER=complex

# Ensemble sampling (1-3 samples, picks the best)
export MESH_ENSEMBLE_SIZE=2

# Cap session cost in USD — BudgetExceededError fires above this
export MESH_MAX_COST_USD=1.00

# Hide the per-turn cost footer
export MESH_HIDE_COST=1

# Skip the browser flow during `mesh login`, fall back to password prompt
export MESH_AUTH_NO_BROWSER=1

Bring-your-own keys (bypasses the shared gateway):

export GOOGLE_API_KEY=your_key   # Gemini direct
export NVIDIA_API_KEY=your_key   # NVIDIA NIM direct

Benchmarks

The bench suite ships with the package under apps/cli/bench/.

# Deterministic compression bench — no LLM, no auth
node $(npm root -g)/@trymesh/cli/bench/static-bench.mjs

# Live bench against Vertex AI Gemini (requires `gcloud auth application-default login`)
node $(npm root -g)/@trymesh/cli/bench/llm-bench.mjs

Current floors on the live CLI source tree (151 files):

Reproducible: same files in, same numbers out. Full methodology in apps/cli/bench/README.md.

License

Proprietary — © Edgar Baumann. All rights reserved.

For licensing inquiries: edgar.baumann@try-mesh.com