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>

Pick a bookmark

Open an interactive picker over your bookmarks and recall the chosen command straight into your shell prompt, ready to edit or run — no copy-paste needed.

suv bookmark pick

Use the arrow keys (or j/k) to move, Enter to recall the selected command onto your prompt, and Esc to cancel.

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.

Frequently Asked Questions

How do I recall a bookmarked command?

Run suv bookmark pick to open an interactive picker and drop the chosen command straight onto your shell prompt, ready to edit or run. Inside the search TUI (suv search), bookmarked entries show a star indicator so you can spot them quickly.

Does removing a bookmark delete the command from my history?

No. suv bookmark remove <COMMAND> only removes the bookmark association — the underlying history entry stays in your database untouched.

Can I add a description to a bookmark?

Yes. Pass -l / --label when adding one, for example suv bookmark add "docker compose up -d" -l "start dev stack". The label appears alongside the command in suv bookmark list.

Are bookmarks included when I export or move machines?

Yes. Bookmarks are stored in your local SQLite database and included in suv export output, so they transfer when you move your history to another machine.

Can I bookmark directly while searching?

Yes. In the search TUI, press Ctrl+B to toggle the bookmark status of the currently selected entry — no need to retype the command.