timeline-report

1# Timeline Report
2 
3Generate a comprehensive narrative analysis of a project's entire development history using claude-mem's persistent memory timeline.
4 
5## When to Use
6 
7Use when users ask for:
8 
9- "Write a timeline report"
10- "Journey into [project]"
11- "Analyze my project history"
12- "Full project report"
13- "Summarize the entire development history"
14- "What's the story of this project?"
15 
16## Prerequisites
17 
18The claude-mem worker must be running. The project must have claude-mem observations recorded.
19 
20**Resolve the worker port** (do this once at the start and reuse `$WORKER_PORT` in every curl call below):
21 
22```bash
23WORKER_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)}"
24```
25 
26This honors `CLAUDE_MEM_WORKER_PORT` env, then `~/.claude-mem/settings.json`, then falls back to the per-UID default `37700 + (uid % 100)` — matching how the worker itself picks its port. Required for multi-account setups (#2101) and any user who has overridden the default port (#2103).
27 
28## Workflow
29 
30### Step 1: Determine the Project Name
31…