Shihwesley Mercator Ai
- 4 repo stars
- Updated February 23, 2026
- shihwesley/mercator-ai
shihwesley-mercator-ai is a Claude Code plugin that provides Merkle-enhanced codebase mapping with O(1) change detection and zero-token staleness prevention for AI agents.
About
shihwesley-mercator-ai is a Claude Code plugin that builds and maintains a Merkle-enhanced map of your codebase so AI agents spend tokens on what actually changed. developers juggling Cursor, Claude Code, and subagents routinely hit stale context: the agent confidently edits the wrong module because its mental model of the repo is outdated. Mercator targets that failure mode with change detection described as O(1) relative to naive full-tree reanalysis, plus explicit staleness prevention so documentation manifests do not silently drift. The workflow emphasizes codebase mapping, architecture analysis, and onboarding—keywords point at outputs like a codebase map markdown file and a mercator JSON manifest suitable for agent consumption. Use it when your repo outgrows casual @-folder prompts, when you spawn parallel subagents, or when you iterate frequently in Operate and need maps to stay current without paying full re-read costs every session.
- Merkle-enhanced codebase mapping with O(1) change detection positioning
- Zero-token staleness prevention so agents do not re-ingest unchanged regions
- Produces structured artifacts such as docs/codebasemap.md and docs/mercator.json per plugin keywords
- Supports parallel subagent onboarding to large repositories
- Single-plugin developer-tools bundle focused on mapping and architecture analysis—not generic chat
Shihwesley Mercator Ai by the numbers
- Data as of Jul 7, 2026 (Skillselion catalog sync)
/plugin install shihwesley-mercator-ai@shihwesley/mercator-aiAdd your badge
Show developers this plugin is listed on Skillselion. Paste this into your README.
| repo stars | ★ 4 |
|---|---|
| Last updated | February 23, 2026 |
| Repository | shihwesley/mercator-ai ↗ |
What it does
Install Mercator so Claude Code agents get Merkle-backed codebase maps, manifest files, and zero-token staleness guards when the repository changes.
Who is it for?
Best when you have medium-to-large repos and run Claude Code subagents and need durable, incrementally updated codebase maps.
Skip if: Tiny single-file projects or teams that do not use agentic coding and only need human-readable READMEs without machine manifests.
What you get
After install, agents can rely on updated mercator manifests and codebase maps that refresh incrementally when files change, cutting redundant token use and wrong-file navigation.
- Merkle-aware codebase map documentation for agent consumption
- Mercator JSON-style manifest aligning agents to repository structure
- Incremental update path when files change instead of full-repo reanalysis
By the numbers
- Bundle metadata lists pluginCount: 1.
- Description claims O(1) change detection and zero-token staleness prevention (author-stated positioning).
- Plugin keywords reference docs/codebasemap.md and docs/mercator.json style outputs plus parallel subagent onboarding.
Recommended Plugins
0xbigboss Linear CliLinear CLI built with Zig1
15195999826 LomomarketplaceLomo's Claude Code Plugin Marketplace1
1broseidon MarketplaceCurated collection of Claude Code plugins for fullstack development teams1
4rgon4ut Cc Zig LspZig LSP plugin for Claude Code4
708u TwigSimplify git worktree and branch management with configurable symlinks, change carrying, and cleanup.22
8avalon8 AvalonclaudemarketAvalon 的 Claude Code 插件市场How it compares
Agent codebase-mapping plugin with Merkle change detection, not a production APM monitor or a marketing analytics integration.
FAQ
Who is Shihwesley Mercator Ai for?
It is for developers who agent-code in Claude Code and need structured repo maps and manifests that stay current as the codebase evolves.
When should I use Shihwesley Mercator Ai?
Use it at the start of a Build sprint to onboard agents to the repo, and again after significant refactors when staleness would mislead subagents.
How do I add Shihwesley Mercator Ai to my agent?
Install the shihwesley/mercator-ai Claude Code plugin, run its mapping workflow in your project root, and point agents at the generated codebase map and mercator JSON artifacts.