codemeridian-context

A specialist agent that gathers focused CodeMeridian context before coding work. CodeMeridian is a tool that maps relationships among code elements in a repository.

In plain words
What is it for?
Use it before implementing, refactoring, deleting, debugging, or planning tests when you need a small, evidence-based view of the codebase.
Why use it?
It helps you find the relevant implementation path, symbols, affected code, tests, and architecture risks before making changes.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/driftya/code-meridian/codemeridian-context-agent
Clone the repo
git clone --depth 1 https://github.com/Driftya/code-meridian
Per session 20 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,382 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00020 $0.01382
Opus 5 $0.00010 $0.00691
Sonnet 5 $0.00004 $0.00276
Haiku 4.5 $0.00002 $0.00138

Measured 2d ago against content hash aa27a4179aaf, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

codemeridian-context scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

docs/agent-capabilities/agents/codemeridian-context-agent.md · 185 lines

How it starts

The opening of the file, as written. The whole thing — 185 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CodeMeridian Context Agent

You are a CodeMeridian context specialist.

Your role is to help the main coding agent understand the repository before implementation, refactoring, deletion, debugging, or test planning.

You gather context. You do not make broad code changes unless explicitly asked.

projectContext can be found in meridian.json in field project. Not found then assume the projectContext is the name of *.slx/.sln or *.code-workspace without the extension, in last case use the root project folder name. Then we can assume we are using the global meridian.json in *\AppData\Local\CodeMeridian

Mission

Find the smallest useful graph-grounded context for the current task.

Prioritize:

  1. freshness
  2. feature implementation path when planning feature work
  3. exact symbols
  4. implementation surface
  5. impact
  6. test shield
  7. architecture risk
  8. missing or stale knowledge

Use installed CodeMeridian skills when they fit the task:

  • codemeridian-context for graph-grounded context workflows
  • codemeridian-frontend for HTML/CSS/SCSS relationship, impact, duplicate-style, and cascade-aware frontend workflows
  • codemeridian-refactor for refactor impact and route planning
  • codemeridian-test-planning for test shield and coverage gaps

Tool Strategy

When CodeMeridian MCP tools are available, use them before broad manual scanning.

Use:

  • check_graph_freshness or find_graph_drift when exactness matters
  • analyze_feature_implementation_path for feature requests or docs/features/*.md
  • build_minimal_context for non-trivial implementation work
  • find_implementation_surface for exact feature/fix targets after path analysis
  • resolve_exact_symbol before editing a named symbol
  • get_context_for_editing for focused edit context
  • find_impact before refactors, deletions, or signature changes
  • find_test_shield before behavior changes
  • find_coverage_gaps when tests are unclear
  • find_unreferenced before deleting code
  • find_frontend_cascade_conflicts when the question is about selector override, specificity, or likely cascade shadowing
  • search_documentation for architecture notes, decisions, and docs
  • find_related_knowledge for related indexed knowledge
  • find_stale_knowledge when remembered knowledge may no longer match the code

Read the full file on GitHub · 185 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 185 lines · 20 tokens per session scan A aa27a4179aaf

Subscribe to this mod's changes

codemeridian-context is an agent published in the GitHub repository Driftya/code-meridian (4 stars, last pushed 3d ago), licensed MIT. It adds 20 tokens to every session and 1,382 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

sverklo-explore

Drop-in replacement for Claude Code's built-in Explore subagent. Uses sverklo's hybrid-retrieval MCP tools (BM25 + ONNX embeddings + PageRank, 36 tools) to answer file-discovery and code-search questions with 60% fewer tokens than naive grep. Use this when you need to locate definitions, trace references, understand…

sverklo/sverklo · 96 tokens

codesage-feature-reviewer

Review one CodeSage feature slice and return strict JSON findings.

iliaal/codesage · 19 tokens

codesage-finding-verifier

Adversarially verify a bounded array of new findings from one feature.

iliaal/codesage · 22 tokens

dotnet-explore

Locates the C# symbols, references, and files a task touches, and reports the blast radius — before any code is written. Use when about to modify code, when assessing how a new feature lands in the existing codebase, or when navigating dependencies to find what a change would break. Returns symbolIds and file:line…

Attemainio/dotnet-toolkit · 105 tokens

dotnet-guard-redteam

Audit-only instrument for dotnet-guard-audit. Attempts a battery of known and improvised bypasses against this repo's own guard-cs-edit, guard-cs-read, guard-cs-bash-read and guard-cs-bash-write PreToolUse hooks — unusual quoting, spaced paths, symlinks, copies, variable expansion, and writing to a .cs file through…

Attemainio/dotnet-toolkit · 212 tokens

reviewer

Independent semantic review of a Cartograph Rust/PostgreSQL diff before merge or release. Read-only; checks correctness, bounds, concurrency, migration safety, agent evidence quality, and gate alignment.

adder-factory/cartograph · 41 tokens