README changes:
- Add go install github.com/...@latest as primary install method
- Add git clone instructions as alternative
- Add PATH setup instructions for bash/zsh and fish shells
- Fix cache database filename (sessions.db -> metrics_v2.db)
CLAUDE.md:
- Fix cache database filename to match actual implementation
New users on fresh Go installations often miss that ~/go/bin needs
to be in PATH. This was causing "command not found" errors after
successful installation.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Document two hard-won patterns in CLAUDE.md's new Architectural
Insights section:
- ANSI Width Calculation: lipgloss.Width() must be used instead of
len() for styled strings, since ANSI escape codes add ~20 bytes per
color code. fmt.Sprintf padding is similarly affected.
- JSON Top-Level Type Detection: bytes.Contains matches nested strings
in JSONL with embedded JSON. Correct approach tracks brace depth and
skips quoted strings to find actual top-level fields.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>