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 | 39.29 KiB/s, done.        
Clone done, wire bytes sent: 593  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: a12c739a8b70d4fd922c08b44f18121b0989f13d
server-id:  44dd870a2e338d8b940c1edab03920f3ce86259d
admin-user: dev (password is "PGVboWHj69")

$ 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), 802.00 B | 78.49 KiB/s, done.        
Pull done, wire bytes sent: 373  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: a12c739a8b70d4fd922c08b44f18121b0989f13d
checkout:     f8c72f4592946c86b5e4b01001b43460bae7f5b7 2026-03-20 03:03:06 UTC
parent:       030da8110aa7867d905798a7d7d3fa814bfec363 2026-03-20 03:03:06 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