https://github.com/micnncim/gh-project

GitHub CLI extension for listing projects and linking/unlinking projects to/from issues/PRs interactively.
https://github.com/micnncim/gh-project

gh gh-extension

Last synced: about 2 months ago
JSON representation

GitHub CLI extension for listing projects and linking/unlinking projects to/from issues/PRs interactively.

• Host: GitHub
• URL: https://github.com/micnncim/gh-project
• Owner: micnncim
• Created: 2021-09-30T03:31:14.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2021-09-30T04:59:30.000Z (over 3 years ago)
• Last Synced: 2024-07-30T18:44:03.404Z (5 months ago)
• Topics: gh, gh-extension
• Language: Shell
• Homepage:
• Size: 5.86 KB
• Stars: 7
• Watchers: 3
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# `gh project` GitHub CLI extension

`gh project` is a [GitHub CLI](https://github.com/cli/cli) extension for listing projects and linking/unlinking projects to/from issues/PRs interactively.

## Installation

```console

$ gh extension install micnncim/gh-project

```

This extension depends on [fzf](https://github.com/junegunn/fzf) as a fuzzy finder. To install using Homebrew:

```console

$ brew install fzf

```

## Usage

```console

$ # Lists all projects in a current repository.

$ gh project list

$ # Lists all projects in a given organization.

$ gh project list --org=acme-org

# # Links a project in a current repository to the issue or PR #123 interactively.

$ gh project add 123

# # Links a project in a given organization to the issue or PR #123 interactively.

$ gh project add 123 --org=acme-org

# # Unlinks a project  a current repository from the issue or PR #123 interactively.

$ gh project remove 123

# # Unlinks a project in a given organization from the issue or PR #123 interactively.

$ gh project remove 123 --org=acme-org

```

## Environment Variables

- `GH_PROJECT_ORGANIZATION` (optional): If this environment variable is set, projects in the organization are listed rather than a current repository even without the flag `--org`.