open

vb open REPOSITORY [VERSION] [OPTIONS]

Description

Open a new connection to the repository name REPOSITORY. A check-out for the repository is created with its root at the current working directory, or in DIR if the --workdir DIR is used. If VERSION is specified then that version is checked out. Otherwise the most recent check-in on the main branch (usually trunk) is used.

REPOSITORY can be the filename for a repository that already exists on the local machine or it can be a URI for a remote repository. If REPOSITORY is a URI in one of the formats recognized by the clone command, the remote repo is first cloned, then the clone is opened. The clone will be stored in the current directory, or in DIR if the --repodir DIR option is used. The name of the clone will be taken from the last term of the URI. For http: and https: URIs, you can append an extra term to the end of the URI to get any repository name you like. For example:

vb open https://code.softbridge.com/projecth2

The base URI for cloning is https://code.softbridge.com/projecth2. The extra new-name term means that the cloned repository will be called new-name.vbyte.

Options

--empty

Initialize check-out as being empty, but still connected with the local repository. If you commit this check-out, it will become a new initial commit in the repository.

-f, --force

Continue with the open even if the working directory is not empty, or if auto-sync fails.

--force-missing

Force opening a repository with missing content

-k, --keep

Only modify the manifest file(s)

--nested

Allow opening a repository inside an opened check-out

--nosync

Do not auto-sync the repository prior to opening even if the autosync setting is on.

--proxy PROXY

Use PROXY as http proxy during sync operation

--repodir DIR

If REPOSITORY is a URI that will be cloned, store the clone in DIR rather than in .

--setmtime

Set timestamps of all files to match their SCM-side times (the timestamp of the last check-in which modified them).

--verbose

If passed a URI then this flag is passed on to the clone operation, otherwise it has no effect

--workdir DIR

Use DIR as the working directory instead of .. The DIR directory is created if it does not exist.

Examples

• Open the remote repository https://visionbyte_developer@code.softbridge.com/projecth2

$ vb open https://visionbyte_developer@code.softbridge.com/projecth2
vb clone "https://visionbyte_developer@code.softbridge.com/projecth2" projecth2.vbyte
password for https://visionbyte_developer@code.softbridge.com/projecth2: **************
remember password (Y/n)? y
Round-trips: 3   Artifacts sent: 0  received: 2692
Clone done, wire bytes sent: 944  received: 3215212  remote: 192.168.1.21
Rebuilding repository meta-data...
   100.0% complete...
...

• create and open a new repository

$ vb init open_repo.vbyte
project-id: 1df4e28b5b7a35c1d88fdc0da28abe1949d90e0a
server-id:  e5111f9ef7a83ad9ed78867ac4bd377423d2ffc2
admin-user: ubuntu (initial remote-access password is "N4bHUaG7qk")

$ vb open open_repo.vbyte -f
project-name: <unnamed>
repository:   /tmp/sphinx_tests/6066a870/open_repo/open_repo.vbyte
local-root:   /tmp/sphinx_tests/6066a870/open_repo/
config-db:    /tmp/sphinx_tests/6066a870/.visionbyte
project-code: 1df4e28b5b7a35c1d88fdc0da28abe1949d90e0a
checkout:     6514a7a1016459479fd2f444389d00364d9364a7 2026-03-31 13:00:30 UTC
tags:         trunk
comment:      initial empty check-in (user: ubuntu)
check-ins:    1

See Also

See also

close, clone