GitHub Duplicate Issue Detection

Workflow

1. Gather Issue Context

• Issue number and title
• Full body content
• Error messages or stack traces
• Keywords and technical terms
• Symptoms or behavior descriptions

2. Search Strategy

gh

• Keyword search from title and body
• Search for similar error messages
• Look for similar symptoms

3. Candidate Inspection

• View full issue with

  gh issue view <number>

• Compare:
  • Root cause (same underlying problem?)
  • Symptoms (identical behavior?)
  • Error messages (exact match or very similar?)
  • Affected components (same area of code?)

• Identical error messages
• Same reproduction steps
• Same root cause with different descriptions
• One issue references the other

• Similar symptoms but different causes
• Related but independent bugs
• Same component but different behaviors

4. Report Findings

gh issue comment <number> --body "This is potentially a duplicate of #123 and #456."

• Single duplicate: "This is potentially a duplicate of #123."
• Two duplicates: "This is potentially a duplicate of #123 and #456."
• Three+ duplicates: "This is potentially a duplicate of #123, #456, and #789."

Examples

Example 1: Clear Duplicate

Title: "Dropdown menu stays open on mobile Safari"
Body: Clicking menu items doesn't close dropdown on iOS

gh issue list --search "dropdown mobile safari"
gh issue list --search "menu doesn't close"
gh issue view 87  # Found similar issue

Title: "Mobile menu not closing after selection"
Body: On iOS Safari, menu stays open after clicking items

• Same symptom (menu stays open)
• Same platform (iOS Safari)
• Same root cause

Example 2: Similar But Not Duplicate

Title: "Form validation error on submit"
Error: "Cannot read property 'value' of null"

gh issue list --search "form validation"
gh issue list --search "Cannot read property value null"
gh issue view 175

Title: "Form submission fails"
Error: "Cannot read property 'email' of undefined"

• Different error messages
• Different null references (value vs email)
• Related area but different bugs

Example 3: Multiple Duplicates

Title: "Build fails with 'module not found' error"
Error: Error: Cannot find module './config'

• Issue #250: Same error, same module
• Issue #280: Same error, same module
• Issue #290: Different module error (not duplicate)

gh issue comment 300 --body "This is potentially a duplicate of #250 and #280."