A safety-first local workflow for backing up, scanning, reviewing, dry-running, and applying approved Chrome bookmark cleanup plans.
Bookmark Audit helps inspect live Chrome bookmarks, create timestamped JSON backups, scan for duplicates and risky URL states, and produce a human-editable cleanup plan that must be reviewed before anything changes.
Designed for local source use with an unpacked Chrome extension and a local Native Messaging host.
npm install, npm run build, then load the repo's chrome-extension folder unpacked in Chrome.
The project is built around a deliberate sequence so cleanup decisions stay visible.
The extension can read Chrome's bookmark tree and create timestamped local JSON backups before scan or apply work.
The CLI scans URLs for duplicates, redirects, dead links, parked domains, local links, and risky statuses, then writes a reviewable cleanup.yaml.
The interactive review flow autosaves decisions and only approved actions are eligible for dry-run or apply.
Common commands include npm run validate, npm run doctor, npm run scan, npm run plan, npm run review, npm run dry-run, and npm run report.
The Bookmark Audit Bridge reads bookmarks, tests the local Native Messaging connection, creates backups, previews approved mutations, applies approved actions, and supports restore flows.
The project keeps AI and automation subordinate to backups, deterministic rules, explicit review, and dry-run previews.
Read-only mode inspects and reports, dry-run executes the mutation path without changing Chrome, and apply only touches actions marked approved: true.
Optional AI opinions can explain ambiguous public web links, but they do not auto-approve deletes, redirects, or uncertain cleanup actions.
Transient failures, access errors, browser-internal URLs, and local/private network links are handled conservatively rather than treated as delete proof.
Backups, plans, logs, caches, reports, result files, local config, and secrets are ignored because they can contain private bookmark data.
Public-safe screenshots from the repository README.
Commands for validation, scanning, planning, review, dry-run, apply, reporting, and diagnostics.
Popup controls for bridge testing, inspecting the tree, creating backups, dry-running, applying, and restoring.
Bookmark Audit is split into shared protocol code, a CLI, a native host, and a Chrome extension bridge.
packages/sharedProtocol types, runtime parsing, bookmark tree utilities, URL classification, and action-resolution logic.
packages/cliSetup, scanning, planning, review, reporting, export, restore setup, and Native Messaging host installation.
A local stdio host and MV3 popup bridge connect Chrome bookmark APIs to approved local plans.
The repository is public for local source use. A Chrome Web Store release would need a separate marketplace pass.