repo-timeline

# Repo Timeline Visualize the history of a repository or branch as a meaningful, grouped timeline — not raw git log, but an engineer-friendly narrative of what changed, when, and why. ## Preferences _On startup, use the Read tool to load `~/.claude/skills/repo-timeline/preferences.md`. If it doesn't exist, use defaults._ ## Context _On startup, use Bash to detect: current git branch, repo root (`git rev-parse --show-toplevel`), repo name (`basename $(git rev-parse --show-toplevel)`), remote URL (`git remote get-url origin`), and GitHub repo name (`gh repo view --json nameWithOwner -q .nameWithOwner`). Skip any that fail._ ## Command routing Check `$ARGUMENTS`: - **`help`** → display help then stop - **`config`** → interactive setup then stop - **`reset`** → delete `~/.claude/skills/repo-timeline/preferences.md`, confirm, stop - **branch name** — if argument looks like a branch name (no `--` prefix), use it as the target branch - **flags** — parse `--since`, `--until`, `--focus`, `--depth`, `--sources` - **empty** — use current branch with defaults ### Flags Parse from `$ARGUMENTS`: - **`--since <time>`** — start of time range (e.g., "2 weeks ago", "2026-01-01", "last tag") - **`--until <time>`** — end of time range (defaults to now) - **`--focus <areas>`** — comma-separated paths or areas to emphasize (e.g., "api,auth,frontend") - **`--depth brief|detailed`** — "brief" for one-liners, "detailed" for full descriptions (default from preferences) - **`--sources <list>`...