Basics

Like with many other tools, git ws works with sub-commands, i.e. the first argument is usually the name of a sub-command to run. Also as with other tools, you can usually get quick help on the command line by calling the tool (or any of it’s sub-commands) with the --help flag. Calling e.g. git ws --help will produce the following output:

Usage: git-ws [OPTIONS] COMMAND [ARGS]...

  Git Workspace - Multi Repository Management Tool.

Options:
  -v, --verbose
  --version      Show the version and exit.
  -h, --help     Show this message and exit.

Commands:
  add            Run 'git add' on PATHS and choose the right git clone...
  checkout       Run 'git checkout' on PATHS and choose the right git...
  clone          Create a git clone from URL and initialize Git Workspace.
  commit         Run 'git commit' on PATHS and choose the right git clone...
  config         Read and modify configuration values.
  default        Set DEFAULT in Manifest to VALUE.
  deinit         Deinitialize Git Workspace.
  dep            Manage Dependencies.
  diff           Run 'git diff' on PATHS or all files (displayed paths...
  fetch          Run 'git fetch' on projects.
  foreach        Run COMMAND on projects.
  git            Run git COMMAND on projects.
  group-filters  Set Group Filter to VALUE.
  info           Git Workspace Information.
  init           Initialize Git Workspace *with* or *without* main project.
  manifest       Manifest Information.
  pull           Run 'git pull' on projects.
  push           Run 'git push' on projects (in reverse order).
  rebase         Run 'git rebase' on projects.
  remote         Manage Remotes.
  reset          Run 'git reset' on PATHS and choose the right git clone...
  rm             Run 'git rm' on PATHS and choose the right git clone...
  status         Run 'git status' on PATHS or all files (displayed paths...
  submodule      Run git submodule COMMAND on projects.
  tag            Create git tag NAME on main repository.
  unshallow      Convert Shallow Clones To Complete Ones.
  update         Create/update all dependent git clones.

In the following, the various commands available are explained in detail.