Timeline Report

This generates a comprehensive narrative report analyzing your project's entire development history from claude-mem's persistent timeline. It pulls every observation, session boundary, and summary the worker has recorded, then spins up a subagent to write a multi-section "Journey Into [Project]" document covering everything from project genesis and architectural pivots to debugging sagas and work patterns. The interesting bit is the Token Economics section, where it queries the SQLite database directly to calculate memory ROI: how much token spend you avoided by having context from previous sessions, both from passive injection and explicit recalls. Fair warning, this can consume 300k+ tokens on large projects, so it confirms before running. Best used when you need to onboard someone new, write a postmortem, or just understand how the hell you got here.

skills.sh installs: 7.1K
GitHub stars: 115.5K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add thedotmack/claude-mem --skill timeline-report --agent claude-code

Installs into .claude/skills of the current project.

Files

Timeline Report

Generate a comprehensive narrative analysis of a project's entire development history using claude-mem's persistent memory timeline.

When to Use

Use when users ask for:

"Write a timeline report"
"Journey into [project]"
"Analyze my project history"
"Full project report"
"Summarize the entire development history"
"What's the story of this project?"

Prerequisites

The claude-mem worker must be running. The project must have claude-mem observations recorded.

Resolve the worker port (do this once at the start and reuse $WORKER_PORT in every curl call below):

WORKER_PORT="${CLAUDE_MEM_WORKER_PORT:-$(node -e "const fs=require('fs'),p=require('path'),os=require('os');const uid=(typeof process.getuid==='function'?process.getuid():77);const fallback=String(37700+(uid%100));try{const s=JSON.parse(fs.readFileSync(p.join(os.homedir(),'.claude-mem','settings.json'),'utf-8'));process.stdout.write(String(s.CLAUDE_MEM_WORKER_PORT||fallback));}catch{process.stdout.write(fallback);}" 2>/dev/null)}"

SKILL.md on GitHub