dbstat

vb dbstat [OPTIONS]

Description

Shows statistics and global information about the repository and/or verify the integrity of a repository.

Options

-b, --brief

Only show essential elements

--db-check

Run PRAGMA quick_check on the repository database

--db-verify

Run a full verification of the repository integrity. This involves decoding and reparsing all artifacts and can take significant time.

--omit-version-info

Omit the SQLite and VisionByte version information

Examples

• Init and open a repository

$ vb init dbstat_repo.vbyte
project-id: 847a7d21f7119ff48028fb85c70c0c200912355f
server-id:  1c1721e2918e87a2904cb4822a837ab47a95a318
admin-user: ubuntu (initial remote-access password is "sBowzWd6Sy")
$ vb open -f dbstat_repo.vbyte
project-name: <unnamed>
repository:   /tmp/sphinx_tests/6bd2a3e9/dbstat_repo/dbstat_repo.vbyte
local-root:   /tmp/sphinx_tests/6bd2a3e9/dbstat_repo/
config-db:    /tmp/sphinx_tests/6bd2a3e9/.visionbyte
project-code: 847a7d21f7119ff48028fb85c70c0c200912355f
checkout:     822f6ae063621f830fdfa68141792ac979d1aced 2026-04-07 06:51:17 UTC
tags:         trunk
comment:      initial empty check-in (user: ubuntu)
check-ins:    1

• Add a couple of check-ins so the repository has content

$ vb sys echo "alpha" > alpha.txt
$ vb add alpha.txt
ADDED  alpha.txt
$ vb ci -m "add alpha"
Committed version: 0201b715aed1acd9a8238812542066558618d302f33936866e505e858e7f3083

$ vb sys echo "beta" > beta.txt
$ vb add beta.txt
ADDED  beta.txt
$ vb ci -m "add beta"
Committed version: e02d860105ae8be892bc8b59349259d5e3fb9da0651ca4326d70bf177cddc022

• Show brief database statistics for the repository

$ vb dbstat --brief
repository-size:   217,088 bytes
project-age:       0 days or approximately 0.00 years.
schema-version:    2015-01-24
vb-version:        2026-04-07 06:49:00 [7552b9904c] [2026.2.26] (gcc-13.3.0)
sqlite-version:    2025-06-06 14:52:32 [b77dc5e0f5] (3.50.1)
database-stats:    53 pages, 4096 bytes/pg, 0 free pages, UTF-8, delete mode