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: 4fe651d6da5f0f0803e7574fded2e2d2edff9b07
server-id:  4c15dd25ef85260639116e4f599ba6557335bf50
admin-user: ubuntu (initial remote-access password is "CeyMmPYZzT")
$ 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: 4fe651d6da5f0f0803e7574fded2e2d2edff9b07
checkout:     8e435f758d17661340bd61f38e68c9b90ee3ae89 2026-04-07 06:51:46 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-04-07 06:51:47        3        3 uv.txt

Remove the unversioned file

$ vb unversioned remove uv.txt