What is meter-reconcile?

A reconciliation tool that compares CocoMeter session totals with an authoritative JSONL transcript. JSONL is a text format containing one JSON record per line.

Use it to reconcile token measurements or run an adapter canary test, with repeat requests handled safely.

It helps detect missing, duplicated, or unsupported usage records without guessing totals from free-form text.

meter-reconcile — Skill for Claude Code and Codex by Snowflake-Labs

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.

Any agent

npx skills add Snowflake-Labs/cocoplus --skill meter-reconcile

Clone the repo

git clone --depth 1 https://github.com/Snowflake-Labs/cocoplus

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/snowflake-labs/cocoplus/meter-reconcile/github.svg)](https://agentmods.dev/skills/snowflake-labs/cocoplus/meter-reconcile)

Your own site

<a href="https://agentmods.dev/skills/snowflake-labs/cocoplus/meter-reconcile"><img src="https://agentmods.dev/badge/skills/snowflake-labs/cocoplus/meter-reconcile/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/snowflake-labs/cocoplus/meter-reconcile"><img src="https://agentmods.dev/badge/skills/snowflake-labs/cocoplus/meter-reconcile.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 975 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

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.

Model	Per session	Once invoked
Fable 5.1	$0.00029	$0.00975
Opus 5	$0.00015	$0.00487
Sonnet 5	$0.00006	$0.00195
Haiku 4.5	$0.00003	$0.00097

Measured 6d ago against content hash 2859ef8b4137, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

meter-reconcile 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 6d 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.

.cortex/skills/cocometer/meter-reconcile.skill.md · 103 lines

How it starts

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

Your objective is to reconcile CocoMeter session totals against an authoritative JSONL transcript using only named transcript fields.

Inputs

Accept either direct invocation arguments or a queued request from .cocoplus/v2-runtime-requests.jsonl:

transcript_path
session_file
out
threshold (default 0.05)
session_id
idempotency_key
optional operation: "adapter-canary" for migration self-tests

Idempotency

Use idempotency_key when supplied. Otherwise derive it from session_id, transcript_path, session_file, and out. If .cocoplus/v2-runtime-settlements.jsonl already contains state: "completed" for the key and out exists, report the existing artifact path and stop.

Do not infer token totals from prose. Only named usage fields from the transcript adapter and numeric runtime meter fields may contribute to totals.

Transcript Adapter Rules

Read JSONL one line at a time. For each valid JSON object, preserve only named fields needed for metering:

id, message_id, parent_id
timestamp
type, role, event, kind
model, model_tier, actual_model
usage, tokens, input_tokens, output_tokens, cache_read_input, cache_write_input

Unknown fields are ignored. Malformed lines produce kind: "other" adapter records and never abort reconciliation.

Deduplicate assistant messages by message_id when present; otherwise use a stable fingerprint of role, timestamp, model, and usage fields.

Reconciliation

Read session_file if present and capture runtime token totals.
Read the transcript through the adapter rules above.
Sum transcript-derived token totals from assistant/tool usage records.
Compute gap_fraction = abs(runtime_tokens - transcript_tokens) / max(runtime_tokens, transcript_tokens, 1).
Mark reconciliation_status as:
- matched when gap_fraction <= threshold
- gap when above threshold
- transcript_only when runtime file is absent but transcript has usage
- not_run when neither source has usage
Preserve configured and actual model tier when available. Set model_drift = true when both exist and differ.

Read the full file on GitHub · 103 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.

6d ago First seen · 103 lines · 29 tokens per session scan A 2859ef8b4137

Subscribe to this mod's changes

meter-reconcile is a skill published in the GitHub repository Snowflake-Labs/cocoplus (720 stars, last pushed 6d ago), licensed MIT. It adds 29 tokens to every session and 975 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-09-03.

Analytics and metrics Debugging LLM agents agentskills cocometer cocoplus cortex cortexai skill-native snowflake

credit-note-fixer

Fix the tiny credit-note formatting bug and rerun the exact targeted test command.

openai/openai-agents-python · 21 tokens

trulens-diagnosis

Diagnose low evaluation scores and generate actionable improvement recommendations.

truera/trulens · 17 tokens

examples-qa

Verify Instructor behavior through the repository's ./examples/ suite in pass, live record, or hermetic replay mode. Use when running selected examples or the corpus, capturing and reusing recorded LLM HTTP responses, diagnosing hub results, or distinguishing real errors, assertion failures, skipped examples, and…

cognesy/instructor-php · 67 tokens

ci-debug

Diagnose a failing CI run against an 11-pattern playbook. Classifies the failure, cites the relevant memory entry, proposes the exact fix command — but NEVER applies without explicit user approval. Use when a specific PR check or GitHub Actions run failed and you want a diagnosis instead of speculation. Don't use for…

yonatangross/orchestkit · 92 tokens

factory-triage

Triage a Factory work item's issue — trace history, understand architecture, diagnose root cause, then advance the stage.

mastra-ai/mastra · 27 tokens

understand-issue

Collaboratively investigate a GitHub issue or bug — trace history, understand architecture, diagnose root cause.

mastra-ai/mastra · 24 tokens