brew tap navio/tap
brew install navio/tap/bm

bm --version

git clone https://github.com/navio/bookmarks
cd bookmarks

go run ./cmd/bm --version

bm help

# add a bookmark
# - if name is omitted, it defaults to the current directory name
# - path defaults to the current directory
bm add proj . --tags work,Go
bm add

# overwrite an existing bookmark (update path; tags only change if provided)
bm add proj .. -f

# list bookmarks
bm ls

# list all tags (with counts)
bm tags

# list as JSON
bm ls --json

# filter by tag
bm ls --tag work

# interactive picker (list)
# enter: print path  •  c: copy path  •  /: filter  •  q: quit
bm find
bm find --tags work,go

# interactive table
# enter: print path  •  c: copy path  •  q: quit
bm table
bm table --tag work

# print the path for a bookmark
bm path proj

# print the path for a bookmark (use it like this)
cd "$(bm path proj)"

# cd via interactive picker (works in subshells)
cd "$(bm find)"
cd "$(bm find --tag work)"

# update tags and/or rename a bookmark
bm update proj --tags work,go,tools
bm update proj --name proj2

# remove a bookmark
bm rm proj2

bm --store /tmp/bm.tsv add tmp .
bm --store /tmp/bm.tsv ls