+title: gtree

A tool to clone and pull whole group trees from a git forge, properly organized on disk.

• Usage

  +begin_src

gtree Sync Gitlab Trees

USAGE: gtree [SCOPE]

ARGS: Only operate on this subtree

OPTIONS: -h, --help Print help information -j, --jobs Number of jobs to run in parallel, 0 is automatic [default: 0]

SUBCOMMANDS: help Print this message or the help of the given subcommand(s) list List Directories sync Download new repositories and delete old ones, also update update Pull and Push new commits to and from the cloned repos

+end_src

• Config Default location for the config file is ~$HOME/.config/gtree/config.toml~, in the toml format, yaml is also supported.

+begin_src toml

Give the forge a easily identifiable name

["gitlab.com"]

Configure which kind of forge this is

Currently only gitlab is supported

type = "gitlab"

Set the domain name to reach the forge at

host = "gitlab.com"

API Token for the forge

for gitlab this is a Personal Access Token

https://gitlab.com/-/profile/personalaccesstokens

token = "HgDAfJ9tfD5xUw2L6SUm"

Directory to clone the repos into

directory = "/home/audron/repo/gitlab.com"

+end_src