bif-clone - import an organisation or project from a hub


0.1.5_8 (yyyy-mm-dd)


bif clone SOURCE [OPTIONS...]


The bif-clone command imports data from a remote bif repository (usually referred to as a hub). The first use for bif-clone is typically to import an organisation and its list of projects:

$ bif init  # if the repository doesn't already exist
$ bif clone ssh://

By default the first clone of a hub is "shallow" meaning that only the organisation (top-level) project is marked as "local" and has all of its topics copied. Non-local projects are indicated by a "*" in certain columns of the bif-list-projects command output and are ignored by bif-sync.

$ bif list projects

The second use for bif-clone is to mark individual projects as local and copy their topics to the local repository.

$ bif clone bif/doc

Note that bif-clone is actually just a wrapper around the bif-clone-org and bif-clone-project commands.

Arguments & Options

A remote hub URL or a project PATH known to the current repository. Required.
--shallow, -s
Normally all of an organisations projects and sub-projects and topics are cloned recursively. This option limits the clone to the actual node requested.

See Also

bif-clone-org, bif-clone-project, bif-sync


Mark Lawrence <>

Copyright And License

Copyright 2015-2017 Mark Lawrence <>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.