Repository navigation
csmesh 0.11.0
Upgrade note
The graph format moves to v15. An index built by 0.10.x is rejected on load (exit 4):
run csmesh index --full once. review baselines are invalidated the same way; run
csmesh review --accept after the first review on 0.11.0.
Freshness
- A file edited without changing its size, within two seconds of being indexed, was
treated as fresh. Under default heal, that meant a stale answer with no[STALE]
marker. Each stamp now carries a SHA-256 of the bytes that were parsed. Inside the
mtime tolerance, the hash decides. An exact mtime match still costs no file read. - Files are stamped before they are read, so a write that lands mid-index can no longer
hide behind a fresh-looking stamp.
Answers that say what they left out
INCOMPLETEnow states rows shown out of the total, e.g.12 of 95 reached member(s) shown, and suggests a budget that fits the whole answer. The old line
could say "nearly complete" with most rows missing, and suggest a budget that
overflowed again.contextreports members past the 20-row cap (… 14 more member(s)), with a
matchingwithheld_membersfield in--json.wherelabels a member that matches only through its type's name[container], and
ranks it below the type itself.
MCP
initializeinstructions now carry the prefer-csmesh-over-grep directive and the
"you are about to → run instead" table, from the same source as the installed skill.
This matters in repositories with no AGENTS.md: there, the server's instructions are
the only rules an agent sees.- Shared parameters (
project,heal,repo,budget,under,depth) are
described once.tools/listdrops from 5,059 to 2,899 tokens. Instructions plus
catalogue together go from 5,368 to 3,865 tokens resident per session.
Exit codes are unchanged.
📦 Installation & Upgrades
Global .NET Tool
dotnet tool update --global CsMeshAutomatic One-Line Install Script
Linux & macOS:
curl -fsSL https://raw.githubusercontent.com/nRafinia/CsMesh/main/install.sh | shWindows (PowerShell):
irm https://raw.githubusercontent.com/nRafinia/CsMesh/main/install.ps1 | iexwinget install nRafinia.CsMeshQuick Setup for AI Assistants
# Install skills and register MCP server in one command:
csmesh install -g --all
csmesh index --full