Bookmarks

Save your most important or frequently needed commands as bookmarks for instant access — with optional labels for context.

Quick Start

Bookmark any command by passing the full command string. Bookmarked commands are highlighted with a star indicator in search results.

suv bookmark add "docker compose up -d"

Commands

Add a bookmark

Save a command as a bookmark. The command string must match an entry in your history database. Optionally attach a human-readable label to describe what the command does.

suv bookmark add <COMMAND> [-l|--label <LABEL>]

Flag	Description
`-l`, `--label <LABEL>`	Optional descriptive label for the bookmark.

List bookmarks

Display all saved bookmarks with their labels (if any). Use --json for machine-readable output.

suv bookmark list [--json]

Flag	Description
`--json`	Output bookmarks as a JSON array. Useful for scripting or integration with other tools.

Remove a bookmark

Delete a bookmark by specifying the exact command string. The underlying history entry is not affected — only the bookmark is removed.

suv bookmark remove <COMMAND>

Bookmarks in the Search TUI

Bookmarks integrate directly into the interactive search interface (suv search):

Ctrl+B — toggle the bookmark status on the currently selected history entry. If the entry is not bookmarked, it becomes bookmarked; if it already is, the bookmark is removed.
Bookmarked commands display a star indicator next to the command text in the search results list, making them easy to spot at a glance.
Bookmarked status is visible in the detail preview pane (toggle with Tab).

Examples

Bookmark with a label

Add a descriptive label so you remember why you saved the command.

suv bookmark add "docker compose up -d" -l "start dev stack"

Bookmark a deploy command

suv bookmark add "kubectl rollout restart deployment/api" -l "restart API pods"

List all bookmarks as JSON

Export your bookmarks for backup, sharing, or scripting.

suv bookmark list --json

Remove a bookmark

suv bookmark remove "docker compose up -d"

How It Works

Bookmarks are stored in your local SQLite history database alongside your command entries. Adding a bookmark creates a lightweight association — it does not duplicate the command data. Bookmarks persist across sessions and survive updates. They are included in suv export output so you can transfer them between machines.

Tip: Use bookmarks for commands you run infrequently but need to get exactly right — deploy scripts, database migrations, complex ffmpeg invocations, or multi-flag curl requests.