Walking docs/09's threat model against the shipped code turned up two things that had gone unnoticed because nothing mechanical was watching either. **The permission list had no test.** "Exactly bookmarks + storage" is CLAUDE.md's first hard rule, the README's headline privacy claim, the store's privacy-tab answer and a line in the privacy policy -- and a single added string in wxt.config.ts would have shipped silently. tests/unit/manifest.test.ts now asserts the list exactly, plus the absence of host_permissions, content_scripts, a background worker and eight other reach-widening keys. Verified to fail by sneaking in 'tabs'. It reads the config as text, with comments stripped, so the assertion cannot be satisfied by something computed at build time -- and because the file's own header says "No host_permissions, no content_scripts", a naive substring check failed on the prose promising the very thing it checks. **"Copy URL" was never built.** docs/06 §3.3 lists it in the row menu and docs/09 T8 describes its mitigation, so the threat model documented a control for a feature that did not exist. Now implemented in browser/clipboard.ts: write-only, on an explicit click, never reads the clipboard, and needs no permission because a transient user activation grants clipboard-write. Also records the measured pass in docs/09 §2 and the reproducibility finding in §5: content-identical rebuilds (every zip entry matches by CRC32) but not byte-identical, because wxt zip records mtimes. The old wording implied more than is true. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
BookmarkMagic
Move your bookmarks between browsers the simple way: with a file. No account, no cloud sync, 100% offline.
A Chrome (MV3) extension for importing, exporting and editing bookmarks and folder trees. English · Tiếng Việt · 日本語.
What it does
- Import HTML, JSON or CSV bookmark files, with a full preview first — counts, folders, depth, duplicates and warnings before anything is written.
- Choose how: into a new dated folder (the safe default), merged into your existing folders, or replacing everything. Replace saves a JSON safety backup first and deletes nothing until that backup is proven.
- Export everything, or just the folders you pick, to HTML (Chrome, Edge, Brave, Firefox, Safari, Vivaldi, Opera), JSON, CSV or Markdown.
- Edit the tree: search, rename, drag & drop, create folders, delete, and find duplicate links — every action reachable from the keyboard.
Privacy
This is the whole point of the project, so it is worth being precise.
- No network access at all. Not analytics, not telemetry, not update pings.
There is no server. A grep gate (
npm run guard) fails the build if anyone addsfetch,XMLHttpRequest,WebSocket,EventSourceorsendBeacon. - Exactly two permissions:
bookmarksandstorage. No host permissions, no content scripts, no background worker. A test asserts the built manifest against that list. - Zero runtime dependencies. Nothing third-party ships in the extension.
- Settings use
chrome.storage.local, neverstorage.sync, so even your preferences stay off any vendor cloud.
Full policy: legal/PRIVACY.md.
Honest limitations
- Favicons cannot be imported — the bookmarks API has no favicon field.
- Imported bookmarks get today's date. Chrome does not let an extension set a bookmark's original creation date. Your exported files keep the real ones.
- CSV is a flattened view: empty folders and "which folder is the toolbar" are not preserved. Use HTML or JSON for a faithful backup.
- Markdown is share-only — BookmarkMagic cannot read it back.
Install
From the Chrome Web Store: ⚠️ link once the listing is live.
From source:
npm ci && npm run build
Then load .output/chrome-mv3/ at chrome://extensions with Developer mode on.
Development
npm run dev
npm run verify is the gate everything else answers to — lint, type-check,
knip, the grep gate and the test suite, in that order. It must be green before
every commit.
The docs/ directory is the binding specification, not notes: where
code and docs disagree, the docs win. Start with CLAUDE.md, then
docs/00–docs/02.
Contributing
Bug reports and translation fixes are welcome via issues. A bug report about parsing is far more useful with a sanitized sample of the file that broke.
Security issues: please follow SECURITY.md rather than opening
a public issue.
Support development
Entirely optional — BookmarkMagic is free software either way.
GitHub Sponsors · Ko-fi · Buy Me a Coffee · Patreon · PayPal
Licence
GPL-3.0-or-later. Also see legal/EULA.md,
legal/DISCLAIMER.md and
legal/THIRD_PARTY_NOTICES.md.
Not affiliated with or endorsed by Google, Chrome, or any browser vendor. Browser names are trademarks of their respective owners.