remote¶
vb remote|remote-url [REF|SUBCOMMAND]
Description¶
View or modify the URLs of remote repositories used for syncing.
The default remote is specially named by VisionByte and corresponds to
the URL used in the most recent sync, push, pull, clone, or
similar command. As such, the default remote can be updated by
VisionByte with each sync command. Other named remotes are persistent.
With no arguments, this command shows the current default remote
URL. If there is no default, it shows off.
With a REF arguments, Make REF the new default URL, replacing the
prior default. REF may be a URL or a NAME from a prior add.
Subcommands¶
vb remote add¶
vb remote add NAME URL
Description¶
Add a new named URL. Afterwards, NAME can be used as a short
symbolic name for URL in contexts where a URL is required. The
URL argument can be default or a prior symbolic name to make
a copy of an existing URL under the new NAME. The default
remote cannot be defined with this subcommand; instead,
use vb remote REF as documented below.
vb remote config-data¶
vb remote config-data
Description¶
DEBUG USE ONLY - Show the name and value of every CONFIG table entry in the repository that is associated with the remote URL store. Passwords are obscured in the output.
vb remote delete¶
vb remote delete NAME
Description¶
Delete a named URL previously created by the add subcommand.
vb remote hyperlink¶
vb remote hyperlink [FILENAME] [LINENUM] [LINENUM]
Description¶
Print a URL that will access the current check-out on the remote repository. Or if the FILENAME argument is included, print the URL to access that particular file within the current check-out. If one or two linenumber arguments are provided after the filename, then the URL is for the line or range of lines specified.
vb remote list (ls)¶
vb remote list|ls
Description¶
Show all remote repository URLs.
vb remote off¶
vb remote off
Description¶
Forget the default URL. This disables autosync.
This is a convenient way to enter airplane mode. To enter
airplane mode, first save the current default URL, then turn the
default off. Perhaps like this:
vb remote add main default
vb remote off
To exit airplane mode and turn autosync back on again:
vb remote main
vb remote scrub¶
vb remote scrub
Description¶
Forget any saved passwords for remote repositories, but continue to remember the URLs themselves. You will be prompted for the password the next time it is needed.
vb remote ui¶
vb remote ui [FILENAME] [LINENUM] [LINENUM]
Description¶
Bring up a web browser pointing at the remote repository, and
specifically to the page that describes the current check-out
on that remote repository. Or if FILENAME and/or LINENUM arguments
are provided, to the specific file and range of lines. This
command is similar to vb remote hyperlink except that instead
of printing the URL, it passes the URL off to the web browser.
Examples¶
Add a new remote named “main” with the URL “https://example.com/repo”
$ vb remote add main https://example.com/repo
Make main the new default URL, replacing the prior default.
$ vb remote main
List all remotes and their URLs
$ vb remote add origin https://example.invalid/repo
$ vb remote list
default https://example.com/repo
main https://example.com/repo
origin https://example.invalid/repo
Use off subcommand to enter airplane mode. This disables autosync.
$ vb remote off
$ vb remote
off
To exit airplane mode and turn autosync back on again
$ vb remote main
$ vb remote
https://example.com/repo