Alternative for git-submodule which embeds the contents of referenced repositories in the master repository.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Niklas Rosenstein 672ca00c96
update .gitignore
1 年之前
src/nr (nr.git-subrepo) bump version to 1.0.1 1 年之前
.gitignore update .gitignore 1 年之前
LICENSE.txt extracted from monorepo 1 年之前 extracted from monorepo 1 年之前
package.yaml (nr.git-subrepo) bump version to 1.0.1 1 年之前 extracted from monorepo 1 年之前


The git-subrepo command is a tool to create a worktree of a remote Git repository and tracking its files.

Advantages over submodules

  • Avoid depending on the longevity of the submodule's remote repository
  • Track changes to the sub repository in the parent


You can get the latest stable version from PyPI. We recommended creating an alias in your Git configuration file so you can access the tool via the git command-line.

$ pip install nr.git-subrepo
$ git config --global alias.subrepo '!nr git-subrepo'
$ git subrepo --version

You may choose to install the tool directly from the source repository. This allows you to get the latest development version.

$ pip install git+
$ git subrepo --version

Usage Example

Any time that you think about adding a Git submodule, you can add a sub repository instead. The git subrepo tool allows you to conveniently add, remove and stage sub repositories. It also provides you with a tool to convert existing Git submodules to sub repositories.

To add a new sub repository:

$ git subrepo add -s

Similar to git submodule, the add command will use the basename of the provided URL as the default path to place the Git worktree at. In the case above, it will be ./library.

$ git -C library remote get-url origin
$ git status
Changes to be committed:
    new file: .gitsubrepos
    new file: library/

The -s option in the add command is used to automatically stage the added sub repository. You can use the git subrepo stage command instead to explicitly add all changes in the sub repository and the proper Git ref to the .gitsubrepos file.

If you have uncommited changes in a sub repository, your changes will be reflected for your sub repository only inside the parent repository. They will not be reflected in the actual sub repository or its remote.

Copyright © 2018 Niklas Rosenstein