advayc/wrapped

Wrapped is a small command line tool for macOS, written in Go, that gives a person a Spotify Wrapped style summary of their own iMessage history. It reads directly from the local Messages database on the Mac, lets the user pick a time period in the terminal, and then opens a locally generated website showing statistics about their texting habits over that period. Everything happens on the user's own machine and nothing is sent anywhere else. Getting started can be as simple as pasting a single curl command into Terminal, which downloads and runs a setup script without needing Go installed or the repository cloned first. That script normally looks for a prebuilt macOS program and downloads it into a local cache if it is not already present. Someone who prefers working from the Go source directly can opt into that path instead, either by setting an environment variable before running the script or by running the Go command directly from a cloned copy of the repository. Using the tool requires macOS to grant the terminal Full Disk Access, since reading the Messages database needs that permission. Once it runs, Wrapped writes its results into a local output folder as an HTML page and a JSON data file, then opens that page automatically in the browser. Reactions like tapbacks are counted separately from regular messages rather than being treated as normal texts. The tool supports several command line flags to control which messages are included in the summary: choosing a specific year, several years at once, the last set number of days, a custom date range, or all available history. There is also a flag to redact sensitive details from the output and one to stop the results page from opening automatically. The README does not mention a software license.