BB ^{Bookmarks Bridge}

Let your local agent manage your browser bookmarks/tabs.

AI Agent -> CLI -> localhost daemon <-> browser extension -> bookmarks API

Skills

npx skills add kvoon3/bb

Web Extension

Download the latest extension package from GitHub Releases.

CLI Usage

Install the CLI globally:

npm -g i @kvoon/bb-cli

Run bb -h to see available commands:

$ bb -h
bb/0.2.2

Usage:
  $ bb <command> [options]

Commands:
  health                        Check daemon and extension status
  tabs                          List open browser tabs
  tabs:create <url>             Open a new browser tab
  tabs:reload [id]              Reload a browser tab
  tabs:close [id]               Close a browser tab
  tabs:activate <id>            Activate a browser tab
  tabs:update <id>              Update a browser tab
  tabs:duplicate <id>           Duplicate a browser tab
  tabs:move <id>                Move a browser tab
  tabs:groups                   List tab groups
  tabs:group                    Group one or more tabs
  tabs:ungroup                  Ungroup one or more tabs
  tabs:groups:update <groupId>  Update a tab group
  tabs:groups:move <groupId>    Move a tab group
  tabs:groups:remove <groupId>  Ungroup all tabs in a tab group
  bookmarks:tree                Read the complete browser bookmark tree
  bookmarks:folders             List all bookmark folders
  bookmarks:search <query>      Search browser bookmarks
  bookmarks:get <id>            Read one browser bookmark node by id
  bookmarks:children <id>       List children of a bookmark folder
  bookmarks:create              Create one or more bookmarks or folders
  bookmarks:update [id]         Update one or more bookmark titles or URLs
  bookmarks:move [id]           Move one or more bookmarks to another folder or position
  bookmarks:remove [id]         Remove one or more bookmarks or empty folders
  bookmarks:remove-tree [id]    Recursively remove a bookmark folder tree
  bookmarks:unused              List bookmarks not visited recently
  bookmarks:organize <path>     Organize bookmarks in a folder by rules (rule targets are created as subfolders of <path>)
  daemon                        Start the bb daemon in the foreground
  daemon:stop                   Stop the running bb daemon

For more info, run any command with the `--help` flag:
  $ bb health --help
  $ bb tabs --help
  $ bb tabs:create --help
  $ bb tabs:reload --help
  $ bb tabs:close --help
  $ bb tabs:activate --help
  $ bb tabs:update --help
  $ bb tabs:duplicate --help
  $ bb tabs:move --help
  $ bb tabs:groups --help
  $ bb tabs:group --help
  $ bb tabs:ungroup --help
  $ bb tabs:groups:update --help
  $ bb tabs:groups:move --help
  $ bb tabs:groups:remove --help
  $ bb bookmarks:tree --help
  $ bb bookmarks:folders --help
  $ bb bookmarks:search --help
  $ bb bookmarks:get --help
  $ bb bookmarks:children --help
  $ bb bookmarks:create --help
  $ bb bookmarks:update --help
  $ bb bookmarks:move --help
  $ bb bookmarks:remove --help
  $ bb bookmarks:remove-tree --help
  $ bb bookmarks:unused --help
  $ bb bookmarks:organize --help
  $ bb daemon --help
  $ bb daemon:stop --help

Options:
  --host <host>  Daemon host (default: 127.0.0.1)
  --port <port>  Daemon port (default: 31337)
  --json         Print raw JSON responses
  -h, --help     Display this message
  -v, --version  Display version number

Examples

Create one or more bookmarks:

# Create a single bookmark
$ bb bookmarks:create --title "Vite" --url https://vitejs.dev

# Create many bookmarks from a JSON file
$ bb bookmarks:create --file bookmarks.json

Update bookmarks:

# Update a bookmark title
$ bb bookmarks:update 123 --title "New title"

# Batch update from a JSON file
$ bb bookmarks:update --file updates.json

Move bookmarks to another folder or path:

# Move to an existing folder by id
$ bb bookmarks:move 123 --parent-id 456

# Move to a path, creating folders if needed
$ bb bookmarks:move 123 --path Websites/Personal

# Batch move from a JSON file
$ bb bookmarks:move --file moves.json

Remove bookmarks or folder trees:

# Remove a single bookmark
$ bb bookmarks:remove 123

# Remove many bookmarks from a JSON file
$ bb bookmarks:remove --file ids.json

# Remove a folder tree by id
$ bb bookmarks:remove-tree 123

# Remove a folder tree by path
$ bb bookmarks:remove-tree --path Archive/Old

Tabs

List open tabs:

$ bb tabs

Open, close, reload, activate, update, duplicate, or move tabs:

$ bb tabs:create https://vitejs.dev
$ bb tabs:reload 123
$ bb tabs:close 123
$ bb tabs:activate 123
$ bb tabs:update 123 --url https://example.com
$ bb tabs:duplicate 123
$ bb tabs:move 123 --index 0

Tab Groups

List tab groups:

$ bb tabs:groups

Group tabs and optionally set title, color, or collapsed state:

$ bb tabs:group --tab-ids 123,456 --title "Work" --color blue
$ bb tabs:group --tab-ids 789 --group-id 1 --title "Archive"

Ungroup tabs or remove a whole group:

$ bb tabs:ungroup --tab-ids 123,456
$ bb tabs:groups:remove 1

Update or move a group:

$ bb tabs:groups:update 1 --collapsed true
$ bb tabs:groups:move 1 --index 0

License

MIT © Kevin Kwong