leaves

vb leaves [OPTIONS]

Description

Find leaves of all branches. By default show only open leaves. The -a|--all flag causes all leaves (closed and open) to be shown. The -c|--closed flag shows only closed leaves.

The --recompute flag causes the content of the leaf table in the repository database to be recomputed.

Options

-a, --all

Show ALL leaves

--bybranch

Order output by branch name

-c, --closed

Show only closed leaves

-m, --multiple

Show only cases with multiple leaves on a single branch

--recompute

Recompute the leaf table in the repository DB

-W, --width N

Width of lines (default is to auto-detect). Must be more than 39 or else 0 no limit, resulting in a single line per entry.

Examples

  • Init and open a repository

$ vb init leaves_repo.vbyte
project-id: 7383f3eda442d3196d8e613b6a2ef0e9bc13f2f5
server-id:  d9b2363f27dbd7c4fe333a6c9614819806540df4
admin-user: ubuntu (initial remote-access password is "53fdAaFu4M")
$ vb open -f leaves_repo.vbyte
project-name: <unnamed>
repository:   /tmp/sphinx_tests/57e1b844/leaves_repo/leaves_repo.vbyte
local-root:   /tmp/sphinx_tests/57e1b844/leaves_repo/
config-db:    /tmp/sphinx_tests/57e1b844/.visionbyte
project-code: 7383f3eda442d3196d8e613b6a2ef0e9bc13f2f5
checkout:     8320c35e5f9516f3d368559d4467be71bbe45ded 2026-04-07 06:51:27 UTC
tags:         trunk
comment:      initial empty check-in (user: ubuntu)
check-ins:    1

  • Create a base check-in and tag it

$ vb sys echo "start" > a.txt
$ vb add a.txt
ADDED  a.txt
$ vb ci -m "base" --tag base
Committed version: 84f8a5f214678719033d4f0fd748c048ca822cbb9b84073972e4eb5a4a415bbd

  • Add a new leaf on trunk

$ vb sys echo "trunk" >> a.txt
$ vb ci -m "work on trunk"
Committed version: 5cf92285341689a5d894513c4e5dd1fbea0930c823f91600542a43afbe4aca8c

  • Return to the tagged base check-in and create another branch leaf

$ vb checkout base
a.txt

$ vb sys echo "feature" > b.txt
$ vb add b.txt
ADDED  b.txt
$ vb ci -m "work on feature" --branch feature/a
Committed version: 347f61f9ba9e208c2c052fc40482494b546c7f9face4a6cb142e0db6c39388c7

  • List open leaves across all branches

$ vb leaves
   (1) 2026-04-07 06:51:27 [347f61f9ba] work on feature (user: ubuntu tags: feature/a) (branched from: [84f8a5f214])
   (2) 2026-04-07 06:51:27 [5cf9228534] work on trunk (user: ubuntu tags: trunk)

See Also

See also

descendants, finfo, info, branch