Bookmarks

Bookmarks in your filesystem.

Install

uv (recommended):

uv tool install --from dkdc-bookmarks 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: