unversioned¶

vb unversioned|uv SUBCOMMAND [OPTIONS]

Description¶

Unversioned files (UV-files) are artifacts that are synced and are available for download but which do not preserve history. Only the most recent version of each UV-file is retained. Changes to an UV-file are permanent and cannot be undone, so use appropriate caution with this command.

Options¶

--mtime TIMESTAMP¶: Use TIMESTAMP instead of now for the add, edit, remove, and touch subcommands.

-R, --repository REPO¶: Use REPO as the repository

Subcommands¶

vb unversioned add¶

vb unversioned add FILE ...

Description¶

Add or update one or more unversioned files in the local repository so that they match FILEs on disk. Changes are not pushed to other repositories until the next sync.

vb unversioned add¶

vb unversioned add FILE --as UVFILE

Description¶

Add or update a single file named FILE on disk and UVFILE in the repository unversioned file namespace. This variant of the add command allows the name to be different in the repository versus what appears on disk, but it only allows adding a single file at a time.

vb unversioned cat¶

vb unversioned cat FILE ...

Description¶

Concatenate the content of FILEs to stdout.

vb unversioned edit¶

vb unversioned edit FILE

Description¶

Bring up FILE in a text editor for modification.

Options¶

--editor NAME¶: Name of the text editor to use

vb unversioned export¶

vb unversioned export FILE OUTPUT

Description¶

Write the content of FILE into OUTPUT on disk

vb unversioned list (ls)¶

vb unversioned list|ls [OPTIONS]

Description¶

Show all unversioned files held in the local repository.

Options¶

--glob PATTERN¶: Show only files that match

--like PATTERN¶: Show only files that match

-l¶: Show additional details for files that match. Implied when list is used.

vb unversioned revert¶

vb unversioned revert [URL] [OPTIONS]

Description¶

Restore the state of all unversioned files in the local repository to match the remote repository URL.

Options¶

-v, --verbose¶: Extra diagnostic output

-n, --dry-run¶: Show what would have happened

--proxy PROXY¶: Use the specified HTTP proxy

vb unversioned remove (rm, delete)¶

vb unversioned remove|rm|delete [OPTIONS] FILE...

Description¶

Remove unversioned files from the local repository. Changes are not pushed to other repositories until the next sync.

Options¶

--glob PATTERN¶: Remove files that match

--like PATTERN¶: Remove files that match

vb unversioned sync¶

vb unversioned sync [OPTIONS] [URL]

Description¶

Synchronize the state of all unversioned files with the remote repository URL. The most recent version of each file is propagated to all repositories and all prior versions are permanently forgotten. The remote account requires the y capability.

Options¶

-v, --verbose¶: Extra diagnostic output

-n, --dry-run¶: Show what would have happened

--proxy PROXY¶: Use the specified HTTP proxy

vb unversioned touch¶

vb unversioned touch FILE ...

Description¶

Update the TIMESTAMP on all of the listed files

Examples¶

Init and open a repository

$ vb init uv_repo.vbyte
project-id: 0b202dbd2f0364e45bdb21e0e800489d04049f12
server-id:  831a26892ce090a3827fff1ae67e821b8eecf9e8
admin-user: ubuntu (initial remote-access password is "MP78AeEmYg")
$ vb open -f uv_repo.vbyte
project-name: <unnamed>
repository:   /tmp/sphinx_tests/c88cda00/uv_repo/uv_repo.vbyte
local-root:   /tmp/sphinx_tests/c88cda00/uv_repo/
config-db:    /tmp/sphinx_tests/c88cda00/.visionbyte
project-code: 0b202dbd2f0364e45bdb21e0e800489d04049f12
checkout:     aca87e450c83c16b2dbfefdd45ac096001f5527c 2026-03-31 13:00:48 UTC
tags:         trunk
comment:      initial empty check-in (user: ubuntu)
check-ins:    1

Add an unversioned file and list entries

$ vb sys echo "uv" > uv.txt
$ vb unversioned add uv.txt
$ vb unversioned list
f4362fdd666c 2026-03-31 13:00:48        3        3 uv.txt

Remove the unversioned file

$ vb unversioned remove uv.txt