CLI Reference¶
vcspull sync
Pull / clone repositories from config.
vcspull add
Add a repository to your config file.
vcspull list
List configured repositories.
vcspull search
Search repos by name, path, or URL.
vcspull status
Show working-tree status for each repo.
vcspull discover
Scan directories for existing repos.
vcspull fmt
Normalize and format config files.
vcspull import
Import repos from GitHub, GitLab, and more.
vcspull worktree
Manage git worktrees declaratively.
Completion
Shell completions for bash, zsh, and fish.
General commands
Completion
Command: vcspull¶
Manage multiple VCS repositories from a single configuration file.
Usage¶
usage: vcspull [-h] [--version] [--log-level level] {sync,list,status,search,add,discover,fmt,import,worktree} ...
Sync Examples¶
$ vcspull sync --all
$ vcspull sync "django-*"
$ vcspull sync --dry-run --all
$ vcspull sync -f ./myrepos.yaml --all
$ vcspull sync -w ~/code myproject
List Examples¶
$ vcspull list
$ vcspull list "django-*"
$ vcspull list --tree
$ vcspull list --json
Search Examples¶
$ vcspull search django
$ vcspull search name:django url:github
$ vcspull search --fixed-strings 'git+https://github.com/org/repo.git'
$ vcspull search --ignore-case --any django flask
Add Examples¶
$ vcspull add mylib https://github.com/example/mylib.git
$ vcspull add mylib URL -w ~/code
$ vcspull add mylib URL --dry-run
Discover Examples¶
$ vcspull discover ~/code
$ vcspull discover ~/code --recursive --yes
$ vcspull discover ~/code -w ~/projects --dry-run
Fmt Examples¶
$ vcspull fmt
$ vcspull fmt -f ./myrepos.yaml
$ vcspull fmt --write
$ vcspull fmt --all
Import Examples¶
$ vcspull import github torvalds -w ~/repos/linux --mode user
$ vcspull import github django -w ~/study/python --mode org
$ vcspull import gitlab gitlab-org/ci-cd -w ~/work --mode org
$ vcspull import codeberg user -w ~/oss --json