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: c054dada65a050e04ac393d2c889005ec0c9d830
server-id: e75e707dc1fecd9384cbe5207867df61ae44684e
admin-user: ubuntu (initial remote-access password is "iVn4mSFcH3")
$ 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: c054dada65a050e04ac393d2c889005ec0c9d830
checkout: 30136677ba212806bed30531e4b8c4d38d52dd43 2026-03-31 13:00:13 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: 8bb3b174808e11e5fa029e1ad227480cc24828fc9b114724aaeb33099fa95f01
Add a descendant on trunk
$ vb sys echo "trunk change" >> readme.md
$ vb ci -m "update trunk"
Committed version: 1a4c20d037102813204db121eeee7bc84a4dbd5073d3756d56db5ef01f49b388
List leaf descendants of the tagged base check-in
$ vb descendants base
=== 2026-03-31 ===
13:00:14 [1a4c20d037] *CURRENT* update trunk (user: ubuntu tags: trunk)
+++ end of timeline (1) +++