# Session Timeline

> Shows a chronological timeline of all Claude Code sessions for a project. Use when the user asks "what's the history of this project", "show me all sessions", "session timeline", or wants to see patterns in their work.

- Skill: `apappascs/session-timeline` (Agent Skill)
- Install (CLI): `npx skillmds@latest add apappascs/session-timeline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/apappascs/session-timeline/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: apappascs (https://skillmd.com/u/apappascs)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/apappascs/session-timeline

---


# Session Timeline

Show chronological history of sessions for a project.

## Step 1: Run the timeline script

```bash
bun run ${CLAUDE_PLUGIN_ROOT}/lib/session-store.ts timeline --project "$(basename $(pwd))"
```

To show only recent sessions:
```bash
bun run ${CLAUDE_PLUGIN_ROOT}/lib/session-store.ts timeline --project "$(basename $(pwd))" --since "2026-04-01"
```

## Step 2: Present the timeline

The script outputs a JSON array of sessions in chronological order. Present as a visual timeline:

```
2026-04-08  ████░░░░  45m  main        (12 messages)
2026-04-09  ██████░░  1h 20m  feat/cli  (34 messages)
2026-04-10  ██░░░░░░  15m  feat/cli    (8 messages)
2026-04-11  ████████  2h 10m  main      (56 messages)
```

Identify patterns:
- Daily cadence or sporadic?
- Long sessions vs short?
- Branch switches?
- Gaps in activity?