ghi-list

name	ghi-list
description	List GitHub issues in a formatted ASCII table. Supports filters like --state, --assignee, --label. Use for issue triage and tracking workflows.
allowed-tools	Bash(gh issue list:*)
version	1.0.0
author	Gas Town

GHI List - Formatted GitHub Issues Table

Display GitHub issues in a clean ASCII box-drawing table format.

Usage

/ghi-list [options]

Options (passed to gh issue list)

• --state open|closed|all - Filter by state (default: open)
• --assignee <user> - Filter by assignee
• --label <label> - Filter by label (can repeat)
• --limit <n> - Max items to fetch (default: 30)
• --author <user> - Filter by author
• --milestone <name> - Filter by milestone

Execution Steps

1. Run gh issue list with any provided options plus --json number,assignees,labels,title,state
2. Format output as an ASCII table using box-drawing characters
3. Truncate titles to fit reasonable terminal width (~45 chars)
4. Show first assignee only, or "-" if none
5. Show first 2-3 labels abbreviated, or "-" if none

Output Format

Use this exact table style with box-drawing characters:

┌───────┬────────────┬─────────────────┬───────────────────────────────────────────────┬────────┐
│ Issue │ Assignee   │ Labels          │ Title                                         │ State  │
├───────┼────────────┼─────────────────┼───────────────────────────────────────────────┼────────┤
│   372 │ max        │ enhancement     │ Create /pr-list and /ghi-list skills          │ OPEN   │
│   371 │ -          │ bug, priority   │ Fix null pointer in auth module               │ OPEN   │
│   370 │ joe        │ -               │ Update documentation for new API              │ CLOSED │
└───────┴────────────┴─────────────────┴───────────────────────────────────────────────┴────────┘

Table Requirements

• Use Unicode box-drawing: ┌ ┐ └ ┘ ├ ┤ ┬ ┴ ┼ │ ─
• Right-align issue numbers
• Left-align text columns
• Pad columns consistently
• For assignees: show login of first assignee, "-" if none
• For labels: show comma-separated names (truncate if >17 chars)
• Show count summary below table: "N issues (M open, K closed)"

Example Commands

# Default - open issues
gh issue list --json number,assignees,labels,title,state

# With filters
gh issue list --state all --label bug --json number,assignees,labels,title,state