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 alias KEYVALUEmulti cd REPOmulti diff ORGmulti exec REPOmulti listmulti open REPOmulti org issues ORGmulti org list ORGmulti org pulls ORGmulti pullsmulti refreshmulti 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 alias KEYVALUESet or unset an alias
USAGE
$ multi alias KEYVALUE
ARGUMENTS
KEYVALUE alias=value
DESCRIPTION
Set or unset an alias
Provide an empty to value to unset the alias
EXAMPLES
Set an alias
$ multi alias myrepo=my-org/my-repo
Unset an alias
$ multi alias myrepo=
See code: src/commands/alias.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 actions|discussions|issues|pulls|pulse|security|settings|wiki]
ARGUMENTS
REPO [default: .] Name of repository.
FLAGS
-f, --file=<value> File to open in github.
-t, --tab=<option> Tab to open in github.
<options: actions|discussions|issues|pulls|pulse|security|settings|wiki>
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 org issues ORGList all issues in the org. Requires GH_TOKEN to be set in the environment.
USAGE
$ multi org issues ORG -s <value> [-b created|repo|author]
ARGUMENTS
ORG Github org
FLAGS
-b, --sort-by=<option> [default: repo] Sort by
<options: created|repo|author>
-s, --since=<value> (required) Only show issues updated after this date
DESCRIPTION
List all issues in the org. Requires GH_TOKEN to be set in the environment.
EXAMPLES
$ multi org issues my-github-org --since 1/1/24
$ multi org issues my-github-org --since friday
See code: src/commands/org/issues.ts
multi org list ORGShow all repositories in the org. Requires GH_TOKEN to be set in the environment.
USAGE
$ multi org list ORG
ARGUMENTS
ORG Github org
DESCRIPTION
Show all repositories in the org. Requires GH_TOKEN to be set in the environment.
ALIASES
$ multi list org
EXAMPLES
$ multi org list my-github-org
See code: src/commands/org/list.ts
multi org pulls ORGList all pull requests in the org. Requires GH_TOKEN to be set in the environment.
USAGE
$ multi org pulls ORG [-i | -d] [-b created|repo|author] [-s <value>]
ARGUMENTS
ORG Github org
FLAGS
-b, --sort-by=<option> [default: repo] Sort by
<options: created|repo|author>
-d, --only-dependabot Only show dependabot
-i, --[no-]ignore-dependabot Ignore dependabot
-s, --since=<value> Only show pull requests created after this date
DESCRIPTION
List all pull requests in the org. Requires GH_TOKEN to be set in the environment.
EXAMPLES
$ multi org pulls my-github-org
$ multi org pulls my-github-org --ignore-dependabot
$ multi org pulls my-github-org --only-dependabot
$ multi org pulls my-github-org --since 1/1/24
$ multi org pulls my-github-org --since friday
See code: src/commands/org/pulls.ts
multi pullsList all your pull requests for added repositories. Requires GH_TOKEN to be set in the environment.
USAGE
$ multi pulls
DESCRIPTION
List all your pull requests for added repositories. Requires GH_TOKEN to be set in the environment.
EXAMPLES
$ multi pulls
See code: src/commands/pulls.ts
multi refreshRefresh the list of repositories and corresponding metadata.
USAGE
$ multi refresh [-o <value>]
FLAGS
-o, --org=<value>... Github org to refresh.
DESCRIPTION
Refresh the list of repositories and corresponding metadata.
See code: src/commands/refresh.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
DESCRIPTION
Setup multi
See code: src/commands/setup.ts
multi task KEYVALUESet or unset an executable task.
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.
See code: src/commands/task/get.ts
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.