multiple-repo-manager
Advanced tools
multi is a CLI for managing node packages across multiple Github organizations and repositories. Autocomplete and user defined aliases are supported for linux and osx users.
$ npm install -g multiple-repo-manager
$ multi --help [COMMAND]
USAGE
$ multi COMMAND
...
In order for multi to work, you must always have your github access token set in the environment - either as GH_TOKEN or GITHUB_TOKEN. See the github docs for how to do this.
After you've set your github token, run multi setup. This command will prompt you for the directory that you want your repos to live. It defaults to ~/repos.
Once you've run multi setup, you're ready to begin adding organizations and/or repositories:
To add an organization:
multi add my-github-org
To add a repository:
multi add my-github-org/my-repo
One the main advantages of using multi is that you can define your own tasks. Theses tasks are stored at ~/.mutli/tasks.yml and can set be set and unset using the multi task command.
open-circle: multi exec . open https://app.circleci.com/pipelines/github/{repo.fullName}
done-with-branch: |
local current_branch=$(git rev-parse --abbrev-ref HEAD)
multi exec . git checkout {repo.defaultBranch}
git pull
git remote prune origin
git branch -D $current_branch
multi add ENTITYmulti cd REPOmulti diff ORGmulti exec REPOmulti listmulti open REPOmulti remove REPOmulti setupmulti task KEYVALUEmulti task get TASKmulti view REPOmulti where REPOmulti add ENTITYAdd a github org or repo. Requires GH_TOKEN to be set in the environment.
USAGE
$ multi add [ENTITY] [--method ssh|https]
ARGUMENTS
ENTITY Github org, repo, or url to add
FLAGS
--method=<option> [default: ssh] Method to use for cloning.
<options: ssh|https>
DESCRIPTION
Add a github org or repo. Requires GH_TOKEN to be set in the environment.
EXAMPLES
Add a github org
$ multi add my-github-org
Add a github org by url
$ multi add https://github.com/my-github-org
Add a github repo by name
$ multi add my-github-org/my-repo
Add a github repo by url
$ multi add https://github.com/my-github-org/my-repo
See code: src/commands/add.ts
multi cd REPOcd into a repository.
USAGE
$ multi cd [REPO]
ARGUMENTS
REPO Name of repository.
DESCRIPTION
cd into a repository.
See code: src/commands/cd.ts
multi diff ORGShow repositories in an org that are not cloned locally. Requires GH_TOKEN to be set in the environment.
USAGE
$ multi diff [ORG]
ARGUMENTS
ORG Github org
DESCRIPTION
Show repositories in an org that are not cloned locally. Requires GH_TOKEN to be set in the environment.
EXAMPLES
$ multi diff my-github-org
See code: src/commands/diff.ts
multi exec REPOExecute a command or script in a repository.
USAGE
$ multi exec [REPO]
ARGUMENTS
REPO Name of repository to execute in. Use "." to specify the current working directory.
DESCRIPTION
Execute a command or script in a repository.
ALIASES
$ multi x
EXAMPLES
Execute a script in a different repository
$ multi exec my-repo yarn compile
Execute a script in the current working directory
$ multi exec . yarn compile
Interpolate values into command execution
$ multi exec . open https://app.circleci.com/pipelines/github/{repo.fullName}
See code: src/commands/exec.ts
multi listList all repositories.
USAGE
$ multi list
DESCRIPTION
List all repositories.
ALIASES
$ multi ls
See code: src/commands/list.ts
multi open REPOOpen a repository in github.
USAGE
$ multi open [REPO] [-f <value> | -t issues|pulls|discussions|actions|wiki|security|pulse|settings]
ARGUMENTS
REPO [default: .] Name of repository.
FLAGS
-f, --file=<value> File to open in github.
-t, --tab=<option> Tab to open in github.
<options: issues|pulls|discussions|actions|wiki|security|pulse|settings>
DESCRIPTION
Open a repository in github.
ALIASES
$ multi o
EXAMPLES
Open the main page of a github repository
$ multi open my-repo
Open the issues tab of a github repository
$ multi open my-repo --tab issues
Open a specific file in a github repository
$ multi open my-repo --file path/to/my/code.ts
See code: src/commands/open.ts
multi remove REPORemove a repository from your local file system.
USAGE
$ multi remove [REPO]
ARGUMENTS
REPO Name of repository.
DESCRIPTION
Remove a repository from your local file system.
ALIASES
$ multi rm
See code: src/commands/remove.ts
multi setupSetup multi
USAGE
$ multi setup [-d <value>]
FLAGS
-d, --directory=<value> Location to setup repositories.
DESCRIPTION
Setup multi
See code: src/commands/setup.ts
multi task KEYVALUEProvide an empty to value to unset the task. This feature is not support on Windows.
USAGE
$ multi task [KEYVALUE] [--interactive]
ARGUMENTS
KEYVALUE task=value
FLAGS
--interactive Open a vim editor to add your task
DESCRIPTION
Set or unset an executable task.
Provide an empty to value to unset the task. This feature is not support on Windows.
EXAMPLES
Set a task
$ multi task build=yarn build
Set a task that uses multi exec
$ multi task circle=multi exec . open https://app.circleci.com/pipelines/github/{repo.fullName}
Unset a task
$ multi task build=
Set a task interactively
$ multi task build --interactive
See code: src/commands/task.ts
multi task get TASKReturn the value of a task.
USAGE
$ multi task get [TASK]
ARGUMENTS
TASK Name of task to get.
DESCRIPTION
Return the value of a task.
multi view REPOView a repository.
USAGE
$ multi view [REPO]
ARGUMENTS
REPO Name of repository.
DESCRIPTION
View a repository.
ALIASES
$ multi v
See code: src/commands/view.ts
multi where REPOPrint location of a repository.
USAGE
$ multi where [REPO] [--remote]
ARGUMENTS
REPO Name of repository.
FLAGS
--remote Return url of repository.
DESCRIPTION
Print location of a repository.
See code: src/commands/where.ts
FAQs
CLI for managing multiple repositories
The npm package multiple-repo-manager receives a total of 4 weekly downloads. As such, multiple-repo-manager popularity was classified as not popular.
We found that multiple-repo-manager demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.