Agent skill · software engineering · mvanhorn
pp-safari-history
Query local Safari browsing history with zero network access: search, visit checks, domain/activity reports, timelines, graphs, dwell estimates, and profile summaries. Trigger phrases: "what have I been browsing", "search my safari history", "what was that page I saw", "what sites do I visit most", "my browsing time report", "my browsing profile", "what was I researching last week", "use safari-history", "run safari-history-pp-cli".
Why this skill is useful
Adds niche commands for querying local Safari browsing history that the AI wouldn't reliably generate on its own.
What it needs
Requires safari-history-pp-cli installed locally. About 4k tokens when loaded. Last updated 2026-08-06. 1,890 stars on the source repository.
What this skill does
<!-- GENERATED FILE — DO NOT EDIT. This file is a verbatim mirror of library/productivity/safari-history/SKILL.md, regenerated post-merge by tools/generate-skills/. Hand-edits here are silently overwritten on the next regen. Edit the library/ source instead. See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". --> pp-safari-history Prerequisites: Install the CLI This skill drives the safari-history-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first: 1. Install via the Printing Press installer: 2. Verify: safari-history-pp-cli --version 3. Ensure $GOPATH/bin (or $HOME/go/bin) is on $PATH. If the npx install fails before this CLI has a public-library category, install Node or use the category-specific Go fallback after publish. If --version reports "command not found" after install, the install step did not put the binary on $PATH. Do not proceed with skill commands until verification succeeds. safari-history-pp-cli reads Safari's local History.db, snapshots it to ~/.cache/safari-history/, builds an offline full-text index, and answers questions about your browsing. Read-only, zero network — nothing leaves the machine. Requires macOS Full Disk Access to read ~/Library/Safari/History.db. Every command supports --json and --select, and the same surface is exposed as MCP tools (all read-only) via safari-history-pp-cli mcp. When to use Historical Safari browsing activity from ~/Library/Safari/History.db: recall pages, check if you visited a site, rank domains, and generate time/profile reports. Anti-triggers Non-macOS — macOS only. Safari does not exist on Linux/Windows, so there is no history DB to read there. Live/open tabs on this Mac are not in History.db. (Synced iCloud tabs open on your other Apple devices ARE available — see icloud-tabs below.) For Chrome history, use chrome-history-pp-cli. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills mvanhorn/pp-safari-history