Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

multiple-repo-manager

Package Overview
Dependencies
Maintainers
1
Versions
62
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

multiple-repo-manager

CLI for managing multiple repositories

  • 2.1.0
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
6
decreased by-40%
Maintainers
1
Weekly downloads
 
Created
Source

Multiple Repo Manager

oclif Version CircleCI Downloads/week License

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.

Getting Started

Install

$ npm install -g multiple-repo-manager
$ multi --help [COMMAND]
USAGE
  $ multi COMMAND
...

Setup

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.

Adding Organizations and Repositories

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

Tasks

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.

Examles

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

Commands

multi add ENTITY

Add 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 REPO

cd 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 ORG

Show 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 REPO

Execute 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 list

List all repositories.

USAGE
  $ multi list

DESCRIPTION
  List all repositories.

ALIASES
  $ multi ls

See code: src/commands/list.ts

multi open REPO

Open 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 REPO

Remove 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 setup

Setup 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 KEYVALUE

Provide 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 TASK

Return 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 REPO

View 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 REPO

Print 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

Keywords

FAQs

Package last updated on 01 Sep 2021

Did you know?

Socket

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.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc