descendants

vb descendants [CHECKIN] [OPTIONS]

Description

Find all leaf descendants of the check-in specified or if the argument is omitted, of the check-in currently checked out.

Options

-R, --repository REPO

Extract info from repository REPO

-W, --width N

Width of lines (default is to auto-detect). Must be greater than 20 or else 0 for no limit, resulting in a one line per entry.

Examples

  • Init and open a repository

$ vb init descendants_repo.vbyte
project-id: 6534fc848ef6229e9aa8df3ec72f979c33854076
server-id:  da29033aa7137b34547ca2beea9c0f34e57954e7
admin-user: ubuntu (initial remote-access password is "kdY8HMcbSE")
$ vb open -f descendants_repo.vbyte
project-name: <unnamed>
repository:   /tmp/sphinx_tests/1337450b/descendants_repo/descendants_repo.vbyte
local-root:   /tmp/sphinx_tests/1337450b/descendants_repo/
config-db:    /tmp/sphinx_tests/1337450b/.visionbyte
project-code: 6534fc848ef6229e9aa8df3ec72f979c33854076
checkout:     c9010f604f4ff1f53a3248059ea2bf6b4b2c9ca2 2026-04-07 06:51:18 UTC
tags:         trunk
comment:      initial empty check-in (user: ubuntu)
check-ins:    1
  • Create a base check-in and tag it

$ vb sys echo "root" > readme.md
$ vb add readme.md
ADDED  readme.md
$ vb ci -m "base" --tag base
Committed version: 4094837b0e7ab8db293bb1a93804fd40d7a1ed0311d2e2d5df99998ec0ab20e2
  • Add a descendant on trunk

$ vb sys echo "trunk change" >> readme.md
$ vb ci -m "update trunk"
Committed version: d8e58e1fea45c72f452569427d94c6f8f29cec56d0e86e5847a79c0cd36165b1
  • List leaf descendants of the tagged base check-in

$ vb descendants base
=== 2026-04-07 ===
06:51:19 [d8e58e1fea] *CURRENT* update trunk (user: ubuntu tags: trunk)
+++ end of timeline (1) +++

See Also

See also

finfo, info, leaves