bookmark

Manage bookmarks that point to specific changes in your repository.

Bookmarks in Pogo are similar to tags and branches in Git combined. They are named references to specific changes that make it easy to find important versions of your code.

Common bookmark patterns:

“main” - The current production/stable version (treated specially by Pogo)
“v1.0.0”, “v2.1.3” - Semantic version tags for releases
“feature-xyz” - Mark the completion of a feature
“before-refactor” - Mark a point before major changes

The “main” bookmark is special, it’s treated as the default branch and is what new users will see when they clone your repository.

This command pushes any changes before running.

Usage

pogo bookmark

Aliases

bookmark list

List all bookmarks in the repository along with the changes they point to.

This shows you all named references in your repository, making it easy to see important versions, releases, and the current “main” branch.

Usage

pogo bookmark list

Aliases

Examples

  # List all bookmarks
  pogo bookmark list

  # Using the short alias
  pogo b l

bookmark remove

Remove a bookmark from the repository.

This permanently removes the named reference to a change, but does not delete the change itself. The change will still exist and can be accessed by its change name.

Usage

pogo bookmark remove <name>

Aliases

rm
delete
del

Examples

  # Remove a bookmark
  pogo bookmark remove old-version

  # Remove the main bookmark (be careful!)
  pogo bookmark remove main

  # Using the short alias
  pogo b rm v1.0.0

bookmark set

Set a bookmark to point to a specific change.

If no change is specified, the bookmark will point to the current change. Setting a bookmark to a change that already has the bookmark will move it.

Bookmarks make changes read-only by default to preserve history. Use the push —force flag if you need to modify a bookmarked change.

Usage

pogo bookmark set <name> [change]

Aliases

Examples

# Set "main" bookmark to current change
pogo bookmark set main

# Set "v1.0.0" bookmark to current change
pogo bookmark set v1.0.0

# Set "main" bookmark to a specific change
pogo bookmark set main sunny-sunset-42

# Move an existing bookmark to current change
pogo bookmark set production

# Using the short alias
pogo b s main