detach

vb detach [REPOSITORY]

Description

Change the project-code and make other changes to REPOSITORY so that it becomes a new and distinct child project. After being detached, REPOSITORY will not longer be able to push and pull from other clones of the original project. However REPOSITORY will still be able to pull from those other clones using the --from-parent-project option of the vb pull command.

This is an experts-only command. You should not use this command unless you fully understand what you are doing.

The original use-case for this command was to create test repositories from real-world working repositories that could be safely altered by making strange commits or other changes, without having to worry that those test changes would leak back into the original project via an accidental auto-sync.

Examples

  • Clone the repository with credentials

$ vb clone http://dev:devpass@127.0.0.1:8889 client_1.vbyte --save-http-password
Round-trips: 2   Artifacts sent: 0  received: 5 | 100% (5/5), 2.20 KiB | 62.80 KiB/s, done.        
Clone done, wire bytes sent: 591  received: 1660  remote: 127.0.0.1
Rebuilding repository meta-data...
  0.0% complete...
  33.3% complete...
  66.6% complete...
  100.0% complete...
Extra delta compression... none found
Vacuuming the database... 
project-id: 08c8d8cb73c4dac879e9fd6108f5d3d3a1cbfb0b
server-id:  43a31f9ea294dc5612fe7989002f25e724bfbf4a
admin-user: dev (password is "XAzYBS7xRc")

$ vb open client_1.vbyte
Pull from http://dev@127.0.0.1:8889
Round-trips: 1   Artifacts sent: 0  received: 0 | 100% (0/0), 798.00 B | 86.47 KiB/s, done.        
Pull done, wire bytes sent: 369  received: 429  remote: 127.0.0.1
note.txt
project-name: <unnamed>
repository:   /tmp/sphinx_tests/e64cdf8d/client_1/client_1.vbyte
local-root:   /tmp/sphinx_tests/e64cdf8d/client_1/
config-db:    /tmp/sphinx_tests/e64cdf8d/.visionbyte
project-code: 08c8d8cb73c4dac879e9fd6108f5d3d3a1cbfb0b
checkout:     43b84bf7fba300ccae0a93d8808a6e5e1aeb91cb 2026-03-31 13:00:15 UTC
parent:       8706f61caca79d7ab64b3b1ff350358bc803cdbc 2026-03-31 13:00:14 UTC
tags:         trunk
comment:      base (user: ubuntu)
check-ins:    2

  • Detach the cloned repository

$ vb detach client_1.vbyte
This change will be difficult to undo. Are you sure (y/N)? y
New project code: 1af32786565063793f74a8bb190d525cf928efed