mcpField
L
list-issues

list-issues

github.com/deevusDevelopment12129 installsUpdated 22w ago
Repository

About list-issues

A command guide for developers using the `tea` CLI to manage issues and PRs. It covers repository-scoped listing, details, filters, export, and counts, and cautions against cross-repository results in multi-repo logins.

Key features

  1. 01List issues for a repository
  2. 02Filter by state, label, and milestone
  3. 03View issue details and comments
  4. 04Export JSON and count issues
  5. 05Find PRs using the same filters

Use cases

  1. 01Review issues in a specific repository
  2. 02Export issue data for backup
  3. 03Count open and closed issues by state

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/deevus/tea-skills --skill list-issues

After installing, type/list-issuesin Claude Code to confirm it loaded.

Details

From the project README

List Issues

List

# Repository-scoped listing: prefer an explicit remote or repo/login.
tea issues list --remote <git-remote> -o simple           # e.g. --remote self-hosted
tea issues list --repo <owner>/<repo> --login <login> -o simple

# Add filters to the same repository-scoped command.
tea issues list --remote <git-remote> --state all -o simple              # include closed
tea issues list --remote <git-remote> --labels "bug,critical" -o simple  # by label
tea issues list --remote <git-remote> --milestones "v1.0" -o simple      # by milestone
tea issues list --remote <git-remote> --assignee "user" --author "user"  # by person
tea issues list --remote <git-remote> --keyword "search term"            # text search
tea issues list --remote <git-remote> --from "2025-01-01" --until "2025-06-01"
tea issues list --remote <git-remote> --output json                      # use json only when parsing with jq
tea issues list --remote <git-remote> --fields "index,title,state,labels,assignees"
tea issues list --remote <git-remote> --page 2 --limit 50

Show

tea issues --remote <git-remote> 42              # detail view
tea issues --remote <git-remote> 42 --comments   # with comments

Export / Count

# Export all issues in this repository to JSON
tea issues list --remote <git-remote> --state all --output json > issues-backup.json

# Count by state in this repository
echo "Open: $(tea issues list --remote <git-remote> --state open --output json | jq length)"
echo "Closed: $(tea issues list --remote <git-remote> --state closed --output json | jq length)"

Tips

  • Do not use bare tea issues list when the user asks for issues for the current repository; in multi-repo logins it can return issues across repositories.

  • Prefer -o simple for listing; use --output json only when parsing with jq

  • --kind pulls searches PRs with the same filters as issues

Comments

Markdown supported