Skip to main content

Manages git repos inside a directory

Project description


PyPI version Unstable package

Manages git repos inside a directory.


pip install repos


Inside a directory with several git repos run:

$ repos
Repos in /Users/hello/repos

STATUS              NAME                            BRANCH
────────────────    ────────────────────────────    ──────────
•   •  1↑  •  •     this-is-a-ahead-repo              master
•  1↓   •  •  •     this-is-a-behind-repo             master
•   •   •  •  •     this-is-a-clean-repo              master
1±      ⚑  •  •     this-is-a-dirty-repo              master
•   ⚑         •     this-repo-has-no-remotes          master
•   •   •  •  3     this-repo-has-three-branches      branch-3
•   •   •  2  •     this-repo-has-two-remotes         master

        1 directories
        1 without a remote ⚑
        1 without upstream ⚑
        1 changed
        1 behind
        1 ahead
        4 clean

To check all available commands:

$ repos help
    repos —  Manages your git repos

    repos                       # Lists all repos in text format
    repos export --json         # Exports all repos as json
    repos export --yaml         # Exports all repos as yaml
    repos show REPO             # Shows the repo details
    repos save                  # Commits local changes
    repos push                  # Pushes up to the upstream
    repos pull                  # Pulls from the upstream
    repos sync                  # Pull from the upstream and pushes up
    repos help                  # Shows this help
    repos version               # Prints the current version


  • Code the repos add <url> subcommand to clone a git repo from an url.

  • Code the repos install [file] subcommand to clone git repos from a file, by default repos.yaml.

  • Code the repos config [repo] [key] [value] subcommand to store git config repos.* in ./.git/config file.

  • Code the repos save [repo] [--yes] subcommand to commit all changes (obeys the = always | never | ask git config).

  • Code the repos push [repo] [--yes] subcommand to send all commits to the upstream (obeys the repo.push = always | never | ask git config).

  • Code the repos pull [repo] [--yes] subcommand to pull all the latest commits from the upstream (obeys the repo.pull = always | never | ask git config).

  • Code the repos sync [repo] [--yes] subcommand to commits all changes, pull the latest commits, and push local commits to the upstream (obeys the repo.sync = always | never | ask git config).

  • Code the repos.enabled git config to turn off all other repos.* configs.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

repos-0.1.16.tar.gz (10.9 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page