reconcile-notes

reconcile-notes is a command for Claude Code from terrene-foundation/kailash-coc-claude-py. It costs 56 tokens per session (1,894 once invoked), scanned A, original, Apache-2.0.

A session-notes maintenance command for reconciling your own notes after Git work such as a merge, pull, rebase, or branch change. It removes notes for work that has already landed and updates references to current project state.

In plain words
What is it for?
Use it after incorporating another operator's changes to clean up your notes and record the latest Git revision.
Why use it?
It prevents personal session notes from becoming stale or claiming that completed work is still pending.

Command for Claude Code

Written for Claude Code: installed under .claude/.

Good fit Use it after incorporating another operator's changes to clean up your notes and record the latest Git revision.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/terrene-foundation/kailash-coc-claude-py/reconcile-notes
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.

Clone the repo
git clone --depth 1 https://github.com/terrene-foundation/kailash-coc-claude-py

Made for: Claude Code.

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.

agentmods badge for reconcile-notes

README.md
[![agentmods](https://agentmods.dev/badge/commands/terrene-foundation/kailash-coc-claude-py/reconcile-notes/github.svg)](https://agentmods.dev/commands/terrene-foundation/kailash-coc-claude-py/reconcile-notes)
Your own site
<a href="https://agentmods.dev/commands/terrene-foundation/kailash-coc-claude-py/reconcile-notes"><img src="https://agentmods.dev/badge/commands/terrene-foundation/kailash-coc-claude-py/reconcile-notes/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.

agentmods 80×15 button for reconcile-notes

Your own site · 80×15
<a href="https://agentmods.dev/commands/terrene-foundation/kailash-coc-claude-py/reconcile-notes"><img src="https://agentmods.dev/badge/commands/terrene-foundation/kailash-coc-claude-py/reconcile-notes.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 56 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,894 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00056 $0.01894
Opus 5 $0.00028 $0.00947
Sonnet 5 $0.00011 $0.00379
Haiku 4.5 $0.00006 $0.00189

Measured 8d ago against content hash 448f23beab29, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

reconcile-notes scanned grade A with 1 finding 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 8d 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.

Runs shell commandslowCapability

Expected in a hook, worth knowing in a rule or an instructions file.

const { execFileSync } = require("child_process");
.claude/commands/reconcile-notes.md · 139 lines

How it starts

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

What /reconcile-notes Is

/reconcile-notes brings YOUR OWN session-notes fragment back into coherence after you incorporate sibling work (a git merge/pull/rebase, or a checkout main). It prunes items the incorporated work has ALREADY LANDED, re-points stale read-first pointers, and stamps the incorporation-guard's lag anchor (last_reconciled_sha) to HEAD so the advisory stops firing until the notes drift again.

It is the RECONCILE half of the #743 coherence layer; the DETECTION half (session-notes-incorporation-guard.js, Wave 2) is what tells you the notes lag and points you here. This command NEVER edits another operator's fragment, NEVER edits the shared forest ledger except through the layout writer, and NEVER re-derives content from anything but the fragment + git state (memory-only).

Scope Fence (BLOCKED outside it)

  • Own fragment only (C4.1): writes ONLY .session-notes.d/<your display_id>.md. Editing a sibling's fragment is BLOCKED (each fragment is single-writer per knowledge-convergence.md MUST-1).
  • Memory-only (C4.2): reason over the fragment's content + git log/git rev-list. NO external re-derivation, NO changelog scrape, NO reading other repos.
  • Prune only with a CITED DURABLE receipt (C4.4 + I9, Decision-1): an item may be pruned ONLY when a durable receipt proves it landed — a commit SHA, a merged-PR number, or a journal slot. "Looks done" / "probably landed" is BLOCKED. Prune targets: landed in-flight items, fixed traps, moved read-first pointers, merged-closed ledger rows.

Workflow

0. Resolve identity + locate your fragment

Resolve your own fragment path — never a hand-slugified filename:

node -e 'const{resolveIdentity}=require("./.claude/hooks/lib/operator-id.js");const{fragmentPathFor}=require("./.claude/hooks/lib/session-notes-layout.js");const id=resolveIdentity(process.cwd(),{});console.log(fragmentPathFor(process.cwd(),id))'

If the fragment does not exist yet (never migrated / never reconciled), there is nothing to reconcile — STOP and report. Read the fragment; note its current last_reconciled_sha (the lag anchor set by the last reconcile or by migration).

Read the full file on GitHub · 139 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. 8d ago First seen · 139 lines · 56 tokens per session scan A 448f23beab29

Subscribe to this mod's changes

reconcile-notes is a command published in the GitHub repository terrene-foundation/kailash-coc-claude-py (12 stars, last pushed 24d ago), licensed Apache-2.0. It adds 56 tokens to every session and 1,894 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 1 finding (runs shell commands). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.