Git Admin

# git-admin

> A package to help manage git repositories through the commandline

Latest version **1.0.1** (published 2019-06-04) · LGPL-3.0-only license · 0 weekly downloads

## Install

```sh
npm install git-admin
pnpm add git-admin
yarn add git-admin
bun add git-admin
```

Provides the command `git-admin`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.1 |
| Published | 2019-06-04 |
| First published | 2019-01-01 |
| Weekly downloads | 0 |
| License | LGPL-3.0-only |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 7 |
| Unpacked size | 85.2 KB |
| Known vulnerabilities | 0 (+25 in 2 direct dependencies) |
| Install scripts | no |
| Author | Dexter Marks-Barber |
| Maintainers | dextermb |
| Keywords | git, node, admin, management, administration, commandline |

## Links

- npm: https://www.npmjs.com/package/git-admin
- Repository: https://github.com/ninetynine/git-admin
- Homepage: https://github.com/ninetynine/git-admin#readme
- Issues: https://github.com/ninetynine/git-admin/issues
- npm.io page: https://npm.io/package/git-admin

## Dependencies (7)

- [conf](https://npm.io/package/conf.md) ^2.1.0
- [axios](https://npm.io/package/axios.md) ^0.18.0
- [dayjs](https://npm.io/package/dayjs.md) ^1.7.8
- [yargs](https://npm.io/package/yargs.md) ^12.0.5
- [pretty-error](https://npm.io/package/pretty-error.md) ^2.1.1
- [prompt-confirm](https://npm.io/package/prompt-confirm.md) ^2.0.4
- [parse-link-header](https://npm.io/package/parse-link-header.md) ^1.0.1

## Alternatives

- [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads
- [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads
- [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads
- [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads
- [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads

## Recent versions

- 1.0.1 (latest) — 2019-06-04
- 1.0.0 — 2019-01-13
- 4.0.1-beta — 2019-01-06
- 4.0.0-beta — 2019-01-06
- 3.1.0-beta — 2019-01-06
- 3.0.2-beta — 2019-01-05
- 3.0.1-beta — 2019-01-05
- 3.0.0-beta — 2019-01-05
- 2.7.1-beta — 2019-01-05
- 2.7.0-beta — 2019-01-05
- 2.6.1-beta — 2019-01-05
- 2.6.0-beta — 2019-01-05
- 2.5.4-beta — 2019-01-04
- 2.5.3-beta — 2019-01-04
- 2.5.2-beta — 2019-01-04
- … 16 more at https://npm.io/package/git-admin/versions

## README

<h1 align="center">
  <br />
  <br />
  Git Admin
  <br />
  <br />
  <br />
</h1>

<h5 align="center"><code>git-admin</code> is a node package that makes it easier to manage GitHub repositories, through commandline.</h5>
<p align="center">
  <a href="https://www.npmjs.com/package/git-admin">
    <img src="https://badgen.net/npm/v/git-admin" />
  </a>
  <a href="https://www.npmjs.com/package/git-admin">
    <img src="https://badgen.net/npm/dt/git-admin" />
  </a>
  <a href="https://www.npmjs.com/package/git-admin">
    <img src="http://img.badgesize.io/https://cdn.jsdelivr.net/npm/git-admin@latest/" />
  </a>
</p>

<br />
<br />

#### Contents

* [Installation](#installation)
* [Initial Setup](#initial-setup)
* [Usage](#usage)
  * [Repositories](#repositories)
    * [List](#list)
    * [Create](#create)
    * [Edit](#edit)
    * [Delete](#delete)
    * [Collaborators](#collaborators)
      * [List](#list-1)
        * [Inactive](#list-inactive)
      * [Add](#add)
      * [Remove](#remove)
    * [Commits](#commits)
      * [List](#list-2)
  * [Branches](#branches)
    * [List](#list-3)
    * [Create](#create-1)
    * [Rename](#rename)
    * [Delete](#delete-1)
    * ⚠️ [Branch Protection](#branch-protection)
      * [Set](#set)
      * [Remove](#remove-1)
  * [Modules](#modules)
      * [Basic Command](#basic-command)
* [FAQ](#faq)
  * [Option Types](#option-types)

## Installation

It is possible to install `git-admin` through [NPM][npm] or [Yarn][yarn].

```
# An example of installing using NPM
npm i -g git-admin
```

```
# An example of installing using Yarn
yarn global add git-admin
```

<hr />

## Initial Setup

Before you can do anything through `git-admin` you must create a personal access token. You can create one by [going here][pt], find out more [here][pt-info].

As `git-admin`'s functionality is currently based around repositories you will need to tick the `repo` checkbox, and if you want to be able to delete repos then tick the `delete_repo` checkbox.

<i>More featured are in the works, so you will have to update the token in the future.</i>

After creating a personal access token you will be presented with a code. Run the following command to store it:

```
# An example of setting the personal access token
git-admin config token <personal-access-token>
```

<hr />

## Usage

### Repositories

When editing or deleting a repository a confirmation prompt will appear before taking any action. Although not recommended the prompt can be skipped by adding `--force` (or `-f`, `--yes`, or `-y`).

#### List

To list repositories for your account simply run:

```
# An example of listing personal repositories
git-admin repo list
```

If you want to get all the repos that are visible to you for another user run:

```
# An example of listing another user's repositories
git-admin repo list --user user
```

If you want to get all the repos that are visible to you for an organization run:

```
# An example of listing an organization's repositories
git-admin repo list --org organization
```

##### Options

All options are optional.

* `--organization`, `--org`, `-o`
  * <small>String</small>
* `--user`, `-u`
  * <small>String</small>
* `--page`, `-p`
  * <small>Number (default `1`)</small>

###### Organization Options
* `--type`, `-t`
  * <small>`all` (default), `public`, `private`, `fork`, `sources`, `member`</small>

###### User Options
* `--type`, `-t`
  * <small>`all` (default), `owner`, `member`</small>
* `--sort`, `-s`
  * <small>`created`, `updated`, `pushed`, `full_name` (default)</small>
* `--direction`, `-d`
  * <small>`asc`, `desc`</small>

###### Personal options
* `--type`, `-t`
  * <small>`all` (default), `owner`, `public`, `private`, `member`</small>
* `--visibility`, `-v`
  * <small>`all` (default), `public`, `private`</small>
* `--affiliation`, `-a`
  * <small>One or combined of: `owner`, `collaborator`, `organization_member` (default all combined)</small>

<small><i>User options included</i></small>

<hr />

#### Create

To create a repository for your account simply run:

```
# An example of creating a personal public repository
git-admin repo create awesome-new-project
```

Depending on if you are an administrator to any organizations will determine if you are able to create organization repositories.

```
# An example of creating a public organization repository. The private option can also be applied here
git-admin repo create organization/awesome-new-project
```

##### Options

All options are optional.

* `--private`, `-p`
  * <small>Boolean</small>

<hr />

#### Edit

To edit a repository for your account simply run:

```
# An example of editing a personal repository
git-admin repo edit user/awesome-new-project
```

Depending on if you are an administrator to any organizations will determine if you are able to edit organization repositories. It's worth noting that even if the new name is prefixed with an organization then only the repository name will be used (`[organization/]repository`).

##### Options

All options are optional.

* `--name`, `-n`
  * <small>String</small>
* `--description`, `--desc`, `-d`
  * <small>String</small>
* `--homepage`, `--url`
  * <small>String</small>
* `--private`, `-p`
  * <small>Boolean</small>
* `--default-branch`
  * <small>String</small>

<hr />

#### Delete

Deleting repositories require the `delete_repo` scope. To delete a repository for your account simply run:

```
# An example of deleting a personal repository
git-admin repo delete user/repository
```

Similarly if you are an organization repository admin then you can also delete organization repositories.

<hr />

#### Collaborators

##### List

To list collaborators for a repository simply run:

```
# An example of listing collaborators for a repository
git-admin repo user list user/repository
```

###### Options

* `--page`, `-p`
  * <small>Number (default `1`)</small>

<hr />

##### List Inactive

To find inactive users for a repository simply run:

```
# An example of finding all inactive collaborators, who haven't commited in a month, to a repository
git-admin repo user inactive user/repository
```

If you have admin permissions on a repository you can also use `--prune` to automatically remove any users found:

```
# An example of finding all inactive collaborators, who haven't commited in a month, to a repository and removing them automatically
git-admin repo user inactive user/repository --prune
```

###### Options

* `--sha`, `--branch`, `-b`
  * <small>String (default `master`)</small>
* `--until`, `--before`, `-u`
  * <small>Date (default previous month from current date), expected format: `MM-DD-YYYY`. Check out [dayjs][dayjs] for more parsing information</small>
* `--prune`, `-p`
  * <small>Boolean</small>

<hr />

##### Add

To add a collaborator to your repository simply run:

```
# An example of adding a collaborator to a personal repository
git-admin repo user add userB user/repository
```

If you are an organization repository admin you can also do this for organization repositories.

###### Options

All options are optional.

* `--permissions`, `--perms`, `--perm`, `-p`
  * <small>`pull`, `push` (default), `admin`</small>

<hr />

##### Remove

To remove a collaborator to your repository simply run:

```
# An example of removing a collaborator to a personal repository
git-admin repo user remove userB user/repository
```

If you are an organization repository admin you can also do this for organization repositories.

<hr />

#### Commits

##### List

To list commits for a repository simply run:

```
# An example of listing commits for a repository
git-admin repo commits list user/repository
```

###### Options

* `--page`, `-p`
  * <small>Number (default `1`)</small>
* `--sha`, `--branch`, `-b`
  * <small>String (default `master`)</small>
* `--path`
  * <small>String</small>
* `--author`, `--user`, `-u`
  * <small>String</small>
* `--since`, `--after`
  * <small>String (default current date), expected format: `MM-DD-YYYY`. Check out [dayjs][dayjs] for more parsing information</small>
* `--after`, `--before`
  * <small>String, expected format: `MM-DD-YYYY`. Check out [dayjs][dayjs] for more parsing information</small>

<hr />

### Branches

When renaming or deleting a branch a confirmation prompt will appear before taking any action. Although not recommended the prompt can be skipped by adding `--force` (or `-f`, `--yes`, or `-y`).

#### List

To list branches for a repository simply run:

```
# An example of listing branches for a repository
git-admin branch list user/repository
```

##### Options

All options are optional.

* `--page`, `-p`
  * <small>Number (default `1`)</small>

#### Create

To create a branch for a repository simply run:

```
# An example of creating a branch for a repository
git-admin branch create user/repository new-branch
```

To create a branch based off another branch simply run:

```
# An example of creating a branch based off a different branch for a repository
git-admin branch create user/repository production --base-branch staging
```

##### Options

All options are optional.

* `--base-branch`, `-b`
  * <small>String (default `master`)</small>

<hr />

#### Rename

To rename a branch for a repository simply run:

```
# An example of renaming a branch for a repository
git-admin branch rename user/repository original renamed
```

<small>⚠️ Remember that this is remotely renaming branches, not locally.</small>

<hr />

#### Delete

To delete a branch for a repository simply run:

```
# An example of deleting a branch for a repository
git-admin branch delete user/repository old-branch
```

<small>⚠️ Remember that this is remotely deleting branches, not locally.</small>

##### Options

All options are optional.

* `--branches`, `-b`
  * <small>Array</small>

<hr />

#### Branch Protection

⚠️ [Branch protection API][branch-protection] is current in preview mode (pre-release). So the following commands should be considered unstable.

When changing repository settings a confirmation prompt will appear before taking any action. Although not recommended the prompt can be skipped by adding `--force` (or `-f`, `--yes`, or `-y`).

##### Set

To set branch protection for a branch simply run:

```
# An example of setting protection on a branch
git-admin branch protection set user/repository master
```

If you want to set protection for multiple branches simply run:

```
# An example of setting branch protection on multiple branch
git-admin branch protection set user/repository --branches master staging production
```

###### Options

All options are optional.

* `--strict-status-checks`, `--strict`, `--srsc`, `--ssc`
  * <small>Boolean</small>
* `--status-checks`, `--contexts`, `--rsc`, `--sc`
  * <small>Array</small>
* `--dismissal-restrict-users`, `--dru`
  * <small>Array</small>
* `--dismissal-restrict-teams`, `--drt`
  * <small>Array</small>
* `--code-owner-review`, `--owner-review`, `--code-owner`, `--rcor`, `--or`, `--co`
  * <small>Boolean</small>
* `--approving-review-count`, `--review-count`, `--arc`, `--rc`
  * <small>Number</small>
* `--restrict-users`, `--ru`
  * <small>Array</small>
* `--restrict-teams`, `--ru`
  * <small>Array</small>
* `--enforce-admins`, `--ea`
  * <small>Boolean</small>
* `--branches`, `-b`
  * <small>Array</small>

<hr />

##### Remove

To remove branch protection for a branch simply run:

```
# An example of removing branch protection on a branch
git-admin branch protection set user/repository master
```

If you want to remove protection for multiple branches simply run:

```
# An example of removing branch protection on multiple branches
git-admin branch protection set user/repository --branches master staging production
```

###### Options

All options are optional.

* `--branches`, `-b`
  * <small>Array</small>

<hr />

### Modules

Modules allow `git-admin` to be extended easily. `git-admin` looks for a directory in your home directory:

```
# Node's `os.homedir` is used for finding your home directory
$HOME/.git-admin/modules
```

Within the modules directory `git-admin` checks for any directories and attempts to require them, because of this you are able to create whatever commands with whatever complexity you want. Check out Yarg's [command module][cm] documentation.

Modules should follow a naming convention as restriction may need to be added in the future.

> git-admin-module-[module-name]

Just make sure that your `package.json` [main][npm-main] is pointing to the entrypoint for your command(s).

#### Basic Command:
```js
// An example of a barebones command
// $HOME/.git-admin/modules/git-admin-module-example/index.js

exports.command = 'example';
exports.desc = 'Example module command';

exports.handler = () => console.warn('hello, world');
```

<hr />

## FAQ

### Option Types

When describing an option for a command, under the aliases, there is a type. These reference a [yargs option type][yargs-option].

* [Array][yargs-array]
* [Boolean][yargs-boolean]
* [Count][yargs-count]
* [Number][yargs-number]
* [String][yargs-string]

[npm]: https://npmjs.com
[npm-main]: https://docs.npmjs.com/files/package.json#main
[yarn]: https://yarnpkg.com
[pt]: https://github.com/settings/tokens
[pt-info]: https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/
[cm]: https://github.com/yargs/yargs/blob/master/docs/advanced.md#providing-a-command-module
[dayjs]: https://github.com/iamkun/dayjs/blob/master/docs/en/API-reference.md#constructor-dayjsexisting-string--number--date--dayjs
[branch-protection]: https://developer.github.com/v3/repos/branches/#get-branch-protection
[yargs-option]: https://github.com/yargs/yargs/blob/master/docs/api.md#optionskey-opt
[yargs-array]: https://github.com/yargs/yargs/blob/master/docs/api.md#array
[yargs-boolean]: https://github.com/yargs/yargs/blob/master/docs/api.md#boolean
[yargs-count]: https://github.com/yargs/yargs/blob/master/docs/api.md#count
[yargs-number]: https://github.com/yargs/yargs/blob/master/docs/api.md#number
[yargs-string]: https://github.com/yargs/yargs/blob/master/docs/api.md#string

---
_Source: https://npm.io/package/git-admin · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._