Clean
Bookmarks
AI-powered bookmark organizer for Chromium. Local-first, bring-your-own-key.
Bookmarks piled into Other Bookmarks,
sorted into a clean tree.
Clean Bookmarks scans the bookmarks piled into Other Bookmarks and the loose items on the Bookmarks Bar, asks an AI to propose a category structure, lets you tune it, then sorts everything into place. One click and it's all back the way it was.
What it does
Two-pass AI
First pass proposes 8–12 top-level categories. Second pass assigns every bookmark. Sub-categories only when 10+ share a clear theme.
You stay in control
Review the proposed categories in the UI. Rename, remove, or add before anything moves.
Your prompt, your categories
The taxonomy prompt is editable in Settings. Bias the structure toward your work or hobbies. Reset with one click.
Non-destructive
Bookmarks Bar and Other Bookmarks roots are never moved. Named folders are flattened; "exclude" ones are left alone.
One-click undo
The current layout is snapshotted before any change. A single click restores it.
Bring your own key
API key stored in chrome.storage.local. Never synced. No install-time host permissions.
Cost transparency
See the estimated API calls, tokens, and cost before you spend a cent.
Resilient
Batched with bounded concurrency, automatic retries, and a safe Unsorted fallback.
A small state machine
Organize
Kicks off the run.
Runs the long job
Stays alive for multi-minute runs.
chrome.bookmarks
Brokers fast read / apply / undo.
The AI
The endpoint you configure.
Read → Sort → Apply
Read scope
Collect everything in Other Bookmarks and loose items on the Bookmarks Bar.
Estimate
Batches, tokens, and dollar cost — shown before you spend.
Propose taxonomy
TypeBox-typed tool returns validated structured args. No JSON parsing.
Review
You edit the proposed categories.
Assign
Every bookmark matched by numeric index, validated against a Zod schema.
Apply
Snapshot taken, then category folders created and bookmarks moved into place.
Undo
Restore the snapshot at any time.
No backend.
No account.
No data store.
Your bookmarks stay in your browser. The only thing that ever leaves your device is bookmark titles and URLs — sent to the AI endpoint you configure.
Build & load
Open chrome://extensions
Enable Developer mode
Load unpacked → pick dist/
Toolbar → Settings: provider, base URL, key, model
Custom for any OpenAI-compatible endpoint.
Under the hood
Clean your bookmarks.
Local-first · Bring-your-own-key · One-click undo
github.com/shafiqimtiaz/clean-bookmarks ↗