Skip to content

Repository files navigation

chromeHistoryCleaner

A small, cross-platform CLI that surgically removes browsing data for a specific domain or keyword from Google Chrome's local databases — URLs, visits, segments, keyword search terms, search keywords, and autofill entries.

⚠️ Deletions are permanent. Always run with -dry-run first, and make sure Chrome is fully closed before cleaning.

Install

Download the latest release for your platform from the Releases page, or build from source:

go build -o chrome-cleaner .

Usage

# Preview what would be deleted (no changes made)
chrome-cleaner -site example.com -dry-run
# Delete data for a domain (prompts for confirmation)
chrome-cleaner -site example.com
# Target a specific profile
chrome-cleaner -site example.com -profile "Profile 1"# List available Chrome profiles
chrome-cleaner -list-profiles
# Print version
chrome-cleaner -version

Flags

FlagDescriptionDefault
-siteDomain or keyword to target for deletion (required)
-profileChrome profile directory nameDefault
-dry-runShow the impact report without deleting anythingfalse
-list-profilesList all detected Chrome profilesfalse
-versionPrint version information and exitfalse

The -site value is matched as a literal substring; SQL LIKE wildcards (%, _) in the input are escaped and treated literally.

Notes

  • Chrome must be closed while cleaning; the tool refuses to run otherwise.
  • Supported platforms: Linux, macOS, Windows.
  • A VACUUM is run after deletion to reclaim disk space.

Development

go vet ./...
go test ./...
go build .

License

MIT

Releases

Packages

Contributors

Languages