Memory & notes

SigMap keeps a small, cross-session decision log so an agent (or you) can recall what we were doing and why without re-reading the whole codebase. It's the cold-start killer: one MCP call at the start of a task instead of a full re-scan.

Three pieces work together:

Piece	What it does	Surface
sigmap note	Append a note to the decision log	CLI
sigmap status	Repo state at a glance — branch, dirty files, index freshness, notes	CLI
read_memory	Return recent notes + last session focus to an agent	MCP tool

Notes are stored as append-only NDJSON at .context/notes.ndjson (alongside SigMap's other state logs). Zero dependencies, fully local.

sigmap note

sigmap note "switched auth to JWT; refresh-token flow still TODO"

Each note records the text, an ISO timestamp, and the current git branch. List recent notes by running note with no text:

sigmap note            # last 10
sigmap note --list 25  # last 25
sigmap note --json     # machine-readable

sigmap status

$ sigmap status
[sigmap] status
  Branch:        feat/auth-refresh
  Working tree:  3 files changed
  Last index:    2h ago (v6.15.0, 412 files) — STALE: 5 files changed since
  Notes:         7 (latest: switched auth to JWT; refresh-token flow still TODO)

Last index reads the usage log and compares the index time against your tracked files' mtimes, so you can see at a glance whether the context an agent is using is stale. Add --json for CI or scripting.

read_memory (MCP)

The 11th MCP tool. Agents call it at the start of a task to recall the decision log plus the last ranking-session focus:

// tools/call
{ "name": "read_memory", "arguments": { "limit": 10 } }

Returns Markdown — recent notes (most recent first) and, when available, the last query and focus files from ask:

# SigMap memory

## Recent notes (2)
- [2026-06-08 10:13 (feat/auth-refresh)] switched auth to JWT; refresh-token flow still TODO
- [2026-06-08 09:40 (feat/auth-refresh)] extracted token store into src/auth/tokens.ts

## Last session
**Last query:** refresh token rotation
**Focus files:** src/auth/tokens.ts, src/auth/middleware.ts

Pair it with note: leave a note when you finish a chunk of work, and the next agent session starts already knowing where you left off.