Aiwg memory-log-render

Generate a human-readable Markdown view from a consumer's JSON Lines event log

install

source · Clone the upstream repo

git clone https://github.com/jmagly/aiwg

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/jmagly/aiwg "$T" && mkdir -p ~/.claude/skills && cp -r "$T/agentic/code/addons/semantic-memory/skills/memory-log-render" ~/.claude/skills/jmagly-aiwg-memory-log-render-758bb6 && rm -rf "$T"

manifest: agentic/code/addons/semantic-memory/skills/memory-log-render/SKILL.md

source content

memory-log-render

Convert a consumer's

.log.jsonl

into a readable

log.md

Markdown file. The rendered view uses greppable line prefixes and groups events by date.

When to Use

On demand: user asks "show me the log" or "render the activity log"
After bulk operations: post-ingest or post-lint when the log has grown
As part of
```
memory-lint --fix
```
: regenerate the rendered view if stale

Parameters

--consumer (optional)

Consumer ID. Resolved via ADR-021 D4 precedence: explicit > wrapper > auto-detect.

--tail (optional, default: all)

Only render the last N entries. Useful for large logs.

--since (optional)

Only render entries after this ISO 8601 date.

--output (optional)

Override output path. Defaults to sibling of

.log.jsonl

→

log.md

(e.g.,

.aiwg/research/.log.jsonl

→

.aiwg/research/log.md

Operation

Resolve consumer — determine which log to render.
Load topology — read
```
memory.topology.log
```
path from consumer's
```
manifest.json
```
.
Read JSONL — parse each line as JSON. Skip malformed lines (warn in output).
Group by date — cluster entries by
```
ts
```
date portion.
Render Markdown — for each entry, produce:

## [2026-04-14] ingest | anthropic-2024-constitutional.pdf
Touched 3 pages: anthropic.md, constitutional-ai.md, summaries/2024-constitutional-ai.md.
Duration: 14.2s. No contradictions.

Write output — overwrite the
```
log.md
```
file (this is a generated view, not an append).
Log event — append a
```
log-render
```
entry to
```
.log.jsonl
```
via
```
memory-log-append
```
.

Rendered Format

# Memory Log — research-complete

> Generated from `.aiwg/research/.log.jsonl` on 2026-04-14T16:00:00Z
> 47 events total

---

## [2026-04-14] ingest | paper.pdf
Touched 3 pages: entities/anthropic.md, concepts/constitutional-ai.md, summaries/paper.md.
Duration: 14.2s. No contradictions.

## [2026-04-14] lint | health check
0 errors, 2 warnings, 5 suggestions. Duration: 3.4s.

## [2026-04-13] query-capture | Constitutional AI comparison
Created synthesis/constitutional-ai-comparison.md (comparison).
Added 2 cross-references.

---

*Rendered by memory-log-render*

Line Prefix Convention

Every operation line starts with

## [YYYY-MM-DD] <op> | <subject>

— this makes the rendered log greppable:

grep "^## \[" .aiwg/research/log.md | tail -5
grep "ingest" .aiwg/research/log.md

Schema Reference

@semantic-memory/schemas/memory-log-event.md