# @nutgaard/gitnext

> Small cli to help prioritize your github tasks

Latest version **0.0.1-beta.20** (published 2022-11-28) · MIT license · 0 weekly downloads

## Install

```sh
npm install @nutgaard/gitnext
pnpm add @nutgaard/gitnext
yarn add @nutgaard/gitnext
bun add @nutgaard/gitnext
```

Provides the command `gitnext`.

## Health

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

Positive: has types; no vulnerabilities.

Warnings: low downloads; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.1-beta.20 |
| Published | 2022-11-28 |
| First published | 2021-03-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 13 |
| Unpacked size | 216.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 3 |
| Author | Nicklas Utgaard |
| Maintainers | nutgaard |

## Links

- npm: https://www.npmjs.com/package/@nutgaard/gitnext
- Repository: https://github.com/nutgaard/gitnext
- Homepage: https://github.com/nutgaard/gitnext#readme
- Issues: https://github.com/nutgaard/gitnext/issues
- npm.io page: https://npm.io/package/@nutgaard/gitnext

## Dependencies (13)

- [ink](https://npm.io/package/ink.md) ^3.0.8
- [meow](https://npm.io/package/meow.md) ^9.0.0
- [open](https://npm.io/package/open.md) 8.0.2
- [chalk](https://npm.io/package/chalk.md) ^4.1.0
- [react](https://npm.io/package/react.md) ^17.0.1
- [js-yaml](https://npm.io/package/js-yaml.md) ^4.0.0
- [clipboardy](https://npm.io/package/clipboardy.md) ^2.3.0
- [emoji-strip](https://npm.io/package/emoji-strip.md) ^1.0.1
- [ink-spinner](https://npm.io/package/ink-spinner.md) ^4.0.1
- [ink-big-text](https://npm.io/package/ink-big-text.md) ^1.2.0
- [ink-gradient](https://npm.io/package/ink-gradient.md) ^2.0.0
- [ink-select-input](https://npm.io/package/ink-select-input.md) ^4.2.0
- [javascript-time-ago](https://npm.io/package/javascript-time-ago.md) ^2.3.4

## Recent versions

- 0.0.1-beta.20 (latest) — 2022-11-28
- 0.0.1-beta.19 — 2022-07-14
- 0.0.1-beta.18 — 2022-06-20
- 0.0.1-beta.17 — 2022-06-13
- 0.0.1-beta.16 — 2022-06-10
- 0.0.1-beta.15 — 2021-09-20
- 0.0.1-beta.14 — 2021-03-25
- 0.0.1-beta.13 — 2021-03-24
- 0.0.1-beta.12 — 2021-03-24
- 0.0.1-beta.11 — 2021-03-24
- 0.0.1-beta.10 — 2021-03-23
- 0.0.1-beta.9 — 2021-03-23
- 0.0.1-beta.8 — 2021-03-23
- 0.0.1-beta.7 — 2021-03-22
- 0.0.1-beta.6 — 2021-03-22
- … 6 more at https://npm.io/package/@nutgaard/gitnext/versions

## README

# GitNext

Small cli to help prioritize your github tasks

<img alt="screenshot of gitnext" src="media/screenshot.png">

The motivation behind this package is to aid in discoverability and prioritization 
when using github as a primary source-control system. 
Github has its own [pull-request view](https://github.com/pulls) which can be extremely useful in many cases.
However it is not always a good match when using code-owners and required reviews from teams.

## Prerequisites
This package uses [github's own cli](https://cli.github.com/), and requires you to be logged in.

Login can be done be issuing the command `gh auth login`, and verified by `gh auth status`.

## Install

To install this package;
`npm i @nutgaard/gitnext -g`

## Run
After installation, run it;
`gitnext`

**NB** Some terminals require a restart in order to pick up on globally installed script. 

## Configuration
GitNext allows the user to configure what repositories and teams they would like to follow.
This configuration is located at `$HOME/.gitnext.yaml` and is automatically created the first time you start GitNext.

An example configuration;
```yaml
sources:
  - username: __self__                     # __self__ is based on your current user.
    ignore:
      - repo: another-username/legacy      # A repository, which you have access to. But dont want to actively follow
      - username: dependabot               # Ignore pull-requests from this user
  - organization: your-awesome-org
    #Due to how large organizations can be, we have to explicit about which teams and repos we are interested in
    include:
      - team: the-best-team                # A team you got access to
      - repo: repository-outside-team      # A repository outside of your primary team
    ignore:
      # In case a team has a repo you're not interested in
      - repo: your-awesome-org/old-legacy  # Ignore this old legacy repo in your org
      - username: annoying-coworker        # Ignore pull-request from this user (within this org)
```

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