Bookmarks

Bookmarks in your filesystem.

Install

uv (recommended):

uv tool install dkdc-bookmarks

cargo:

cargo install dkdc-bookmarks --features app,webapp

You can use uvx to run it without installing:

uvx --from dkdc-bookmarks bookmarks

Usage

bookmarks [OPTIONS] [URLS]...

Configuration

Bookmarks looks for a config file in this order:

1. --bookmarks-file / -f flag (explicit path)
2. --local / -l flag (creates ./bookmarks.toml if missing)
3. bookmarks.toml in the current directory (must exist)
4. $HOME/.config/bookmarks/bookmarks.toml (global, auto-created)

Example:

[urls]
dkdc-bookmarks = "https://github.com/lostmygithubaccount/bookmarks"
github = { url = "https://github.com", aliases = ["gh"] }

[urls.linkedin]
url = "https://linkedin.com"
aliases = ["li"]

[groups]
socials = ["gh", "linkedin"]

URLs can be plain strings, inline tables with aliases, or expanded tables. Groups reference url names or aliases.

Use the --config or --app or --webapp option to edit the configuration file.

Open urls

Open urls by name, alias, or group:

bookmarks github
bookmarks gh linkedin
bookmarks socials

You can input multiple url names, aliases, or groups at once. They will be opened in the order they are provided.

Options

Available options:

Flag	Short	Description
--bookmarks-file <PATH>	-f	Use a specific bookmarks file
--global	-g	Use global config, ignore local bookmarks.toml
--local	-l	Use local config (./bookmarks.toml), create if missing
--config	-c	Open active bookmarks file in $EDITOR (use -gc for global)
--app	-a	Open desktop app (requires app feature)
--webapp	-w	Open the web app in browser (requires webapp feature)
--help	-h	Print help
--version	-V	Print version