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
leaftable 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: e34557a6b6bfcd22ae8fd8dab21630896ac31d7e
server-id: c7f60f7a478dc5c12abf6ed83121a3e0b9c5f97b
admin-user: ubuntu (initial remote-access password is "7uWy9HpPMo")
$ 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: e34557a6b6bfcd22ae8fd8dab21630896ac31d7e
checkout: b9f5bf9fc8606a5cafd83090c73027745983e0e6 2026-03-31 13:00:24 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: 23ec7352267f32a8707e95d4a5b2aad65f283a6c3d2feff674664288bd188349
Add a new leaf on trunk
$ vb sys echo "trunk" >> a.txt
$ vb ci -m "work on trunk"
Committed version: e5a47cd44d0d5295ff448a6a94ecf6f24c2931e77703cd6b184d91e72ac4cfcd
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: 93fcfb74563609af111bac44a8edf1fbdae6f834ef11920f5a3a3e7a8036f8d4
List open leaves across all branches
$ vb leaves
(1) 2026-03-31 13:00:25 [93fcfb7456] work on feature (user: ubuntu tags: feature/a) (branched from: [23ec735226])
(2) 2026-03-31 13:00:25 [e5a47cd44d] work on trunk (user: ubuntu tags: trunk)
See Also¶
See also