URL Bookmarker#

Save, categorize, search, and export web bookmarks with tag and folder organization. Uses local JSON storage.

Commands#

Add a bookmark#

text

bookmark add <url> [title] [-t tags] [-f folder]

• url (required): The web address to save
• title (optional): Custom title, defaults to URL hostname
• -t tags: Comma-separated tags (e.g. -t crypto,research)
• -f folder: Folder name (e.g. -f DeFi)

List bookmarks#

text

bookmark list [filter]

• No filter: shows all bookmarks
• -t tag: filter by tag
• -f folder: filter by folder
• -a: show all tags and folders

Search bookmarks#

text

bookmark search <query>

Full-text search across URLs, titles, and tags.

Tag a bookmark#

text

bookmark tag <url> <tags>

Add tags to an existing bookmark. Use -t to replace all tags.

Remove a bookmark#

text

bookmark remove <url>

Export bookmarks#

text

bookmark export [format]

Formats: json (default), html (browser-importable), csv

Storage#

Bookmarks stored in assets/bookmarks.json:

json

{
  "urls": [{ "url": "...", "title": "...", "tags": [], "folder": null, "added": "ISO date" }],
  "tags": ["tag1", "tag2"],
  "folders": ["folder1"]
}

Script Usage#

Run via Python (from skill directory):

text

$env:PYTHONIOENCODING="utf-8"; uv run python scripts/bookmark_manager.py <command> [args]

Examples:

text

uv run python scripts/bookmark_manager.py add https://example.com "Example Site" -t research -f DevTools
uv run python scripts/bookmark_manager.py list -t crypto
uv run python scripts/bookmark_manager.py search "uniswap"
uv run python scripts/bookmark_manager.py export html