insights-archive
Insights Archive
Archive and manage Claude Code /insights reports to track how your usage patterns evolve over time.
Usage
/insights-archive archive # Save current report with timestamp
/insights-archive list # See all archived reports
/insights-archive open # Open current report in browser
/insights-archive open <date> # Open archived report by date
/insights-archive diff <d1> <d2> # Compare two archived reports
/insights-archive # Show help
Commands
archive
Saves the current /insights report with a timestamp.
/insights-archive archive
Output:
Archived to: ~/.claude/usage-data/archives/report-2026-02-04-1335.html
Note: Run /insights first to generate a fresh report before archiving.
list
Shows all archived reports with their dates.
/insights-archive list
Output:
Archived insights reports:
2026-02-01-1422
2026-02-04-1335
Use '/insights-archive open <date>' to view one.
open
Opens the current report or an archived report by date.
/insights-archive open # Opens current report
/insights-archive open current # Same as above
/insights-archive open 2026-02-04 # Opens archived report matching date
diff
Opens two archived reports side-by-side for manual comparison.
/insights-archive diff 2026-02-01 2026-02-04
Both reports open in browser tabs for comparison.
Why Archive?
Tracking how your Claude Code usage patterns evolve over time is valuable:
- See workflow improvements — Are git operations decreasing as you add custom skills?
- Track friction resolution — Did the suggestions from last month's report get addressed?
- Measure learning — How are your interaction patterns maturing?
This aligns with the "knowledge compounds" thesis — your usage data is another form of knowledge that benefits from historical context.
Prerequisites
Requires the insights-archive shell script in your PATH.
Setup (if not already installed):
# Clone dotfiles or copy the script
curl -o ~/.local/bin/insights-archive \
https://raw.githubusercontent.com/jonathanprozzi/dotfiles/main/bin/insights-archive
chmod +x ~/.local/bin/insights-archive
Or if using jonathanprozzi/dotfiles, the script is at bin/insights-archive.
Implementation
Execute the command using the shell script:
insights-archive <command> [args]
Parse the user's arguments and pass them through. Report the output back to the user.
Commands map directly:
/insights-archive archive→insights-archive archive/insights-archive list→insights-archive list/insights-archive open <date>→insights-archive open <date>/insights-archive diff <d1> <d2>→insights-archive diff <d1> <d2>
If no arguments provided, show the help output from the script.