Awesome Open Source
Awesome Open Source

tsrc: manage groups of git repositories

Overview Installation Usage example Documentation Release notes Contributing License


This project was originally hosted on the TankerHQ organization, which was my employer from 2016 to 2021. They kindly agreed to give back ownership of this project to me. Thanks!


tsrc is a command-line tool that helps you manage groups of several git repositories.

It can be seen in action on


tsrc does not adhere strictly to the semver specification. So before upgrading to a new version, please take the time to read the Changelog first!


The recommended way to install tsrc is to use pipx

  • Make sure to have Python 3.7 or later installed.
  • Install pipx
  • Run pipx install tsrc.

Usage Example

  • Create a manifest repository. ([email protected]/manifest)
  • Push a file named manifest.yml looking like:
  - url: [email protected]/foo.git
    dest: foo

 -  url: [email protected]/bar.git
    dest: bar
  • Create a new workspace with all the repositories listed in the manifest:
$ tsrc init [email protected]/manifest.git

:: Configuring workspace in /path/to/work
=> Cloning missing repos
* (1/2) foo
* (2/2) bar
: Configuring remotes
  • Synchronize all the repositories in the workspace:
$ tsrc sync
=> Updating manifest
:: Configuring remotes
:: Synchronizing workspace
* (1/2) foo
=> Fetching origin
=> Updating branch
Already up to date
* (2/2) bar
=> Updating branch
Updating 29ac0e1..b635a43
 bar.txt | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 bar.txt


For more details and examples, please refer to tsrc documentation.

Release notes

Detailed changes for each release are documented in the changelog.


We welcome feedback, bug reports, and bug fixes in the form of pull requests.

Detailed instructions can be found in the documentation.


tsrc is licensed under a BSD 3-Clause license.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Python (1,141,333
Cli (15,901
Github (8,188
Git (7,632
Gitlab (1,312
Related Projects