github-projects

# GitHub Projects CLI

GitHub Projects (v2) management via `gh project` commands. Requires the `project` scope which can be added with `gh auth refresh -s project`.

## Prerequisites

Verify authentication includes project scope:

```bash
gh auth status  # Check current scopes
gh auth refresh -s project  # Add project scope if missing
```

## Quick Reference

### List & View Projects

```bash
# List your projects
gh project list

# List org projects (including closed)
gh project list --owner ORG_NAME --closed

# View project details
gh project view PROJECT_NUM --owner OWNER

# Open in browser
gh project view PROJECT_NUM --owner OWNER --web

# JSON output with jq filtering
gh project list --format json | jq '.projects[] | {number, title}'
```

### Create & Edit Projects

```bash
# Create project
gh project create --owner OWNER --title "Project Title"

# Edit project
gh project edit PROJECT_NUM --owner OWNER --title "New Title"
gh project edit PROJECT_NUM --owner OWNER --description "New description"
gh project edit PROJECT_NUM --owner OWNER --visibility PUBLIC

# Close/reopen project
gh project close PROJECT_NUM --owner OWNER
gh project close PROJECT_NUM --owner OWNER --undo  # Reopen
```

### Link Projects to Repos

```bash
# Link to repo
gh project link PROJECT_NUM --owner OWNER --repo REPO_NAME

# Link to team
gh project link PROJECT_NUM --owner ORG --team TEAM_NAME

# Unlink
gh project unlink PROJECT_NUM --owner OWNER --repo REPO_NAME
```

## Project Items

### Add Existing Issues/PRs

```bash
# Add issue to project
gh project item-add PROJECT_NUM --owner OWNER --url https://github.com/OWNER/REPO/issues/123

# Add PR to project
gh project item-add PROJECT_NUM --owner OWNER --url https://github.com/OWNER/REPO/pull/456
```

### Create Draft Items

```bash
gh project item-create PROJECT_NUM --owner OWNER --title "Draft item" --body "Description"
```

### List Items

```bash
# List items (default 30)
gh project item-list PROJECT_NUM --owner OWNER

# List more items
g