Github Issues

GitHub Issues (curl)

Fetch GitHub issues for public repositories using the GitHub REST API with curl. No authentication required for public repos.

Prerequisites

• curl - Usually pre-installed on Linux/macOS
• jq - For JSON parsing (optional but recommended)

  sudo apt install jq  # Ubuntu/Debian
  brew install jq      # macOS
  

Quick Commands

Get Repo Info from Git Remote

# Extract owner/repo from current git remote
REPO=$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')
echo $REPO  # e.g., FnSK4R17s/chakravarti-cli

Fetch Open Issues

# Basic - list open issues (JSON)
curl -s "https://api.github.com/repos/OWNER/REPO/issues?state=open&per_page=15"

# With current repo
REPO=$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')
curl -s "https://api.github.com/repos/$REPO/issues?state=open&per_page=15"

Pretty Print Issue Titles

REPO=$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')
curl -s "https://api.github.com/repos/$REPO/issues?state=open&per_page=15" | jq -r '.[] | "#\(.number) \(.title)"'

Detailed Issue List (Table Format)

REPO=$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')
curl -s "https://api.github.com/repos/$REPO/issues?state=open&per_page=20" | \
  jq -r '["#", "TITLE", "LABELS", "CREATED"], ["---", "---", "---", "---"], (.[] | [.number, .title[:50], (.labels | map(.name) | join(",")), .created_at[:10]]) | @tsv'

API Parameters

Examples

Filter by Label

REPO=$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')
curl -s "https://api.github.com/repos/$REPO/issues?labels=bug&state=open" | jq -r '.[] | "#\(.number) \(.title)"'

Get Single Issue Details

REPO=$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')
ISSUE_NUM=42
curl -s "https://api.github.com/repos/$REPO/issues/$ISSUE_NUM" | jq '{title, body, state, labels: [.labels[].name]}'

Get Issue with Comments

REPO=$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')
ISSUE_NUM=42

# Issue details
curl -s "https://api.github.com/repos/$REPO/issues/$ISSUE_NUM"

# Comments
curl -s "https://api.github.com/repos/$REPO/issues/$ISSUE_NUM/comments" | jq '.[] | {user: .user.login, body: .body[:200]}'

Recently Updated Issues

REPO=$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')
curl -s "https://api.github.com/repos/$REPO/issues?state=all&sort=updated&direction=desc&per_page=10" | \
  jq -r '.[] | "\(.state | if . == "open" then "🟢" else "🔴" end) #\(.number) \(.title[:40]) (updated: \(.updated_at[:10]))"'

One-Liner for Current Repo

Copy-paste ready command:

curl -s "https://api.github.com/repos/$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')/issues?state=open&per_page=15" | jq -r '.[] | "#\(.number) \(.title)"'

Rate Limiting

• Unauthenticated: 60 requests/hour per IP
• Authenticated: 5,000 requests/hour

Check your rate limit:

curl -s "https://api.github.com/rate_limit" | jq '.rate'

Integration with Chakravarti

Create Spec from Issue

REPO=$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')
ISSUE_NUM=42

# Fetch issue and create spec
ISSUE=$(curl -s "https://api.github.com/repos/$REPO/issues/$ISSUE_NUM")
TITLE=$(echo "$ISSUE" | jq -r '.title')
BODY=$(echo "$ISSUE" | jq -r '.body')

echo "Creating spec for: $TITLE"
ckrv spec new --name "issue-$ISSUE_NUM" --description "$BODY"

Check for Existing Brainstorms

Before diving into an issue, check if there's already a brainstorm document:

Quick Lookup

# Check if issue #12 has a brainstorm
ls brainstorming/ | grep -E "^issue-0*12-" && echo "📝 Brainstorm exists!" || echo "No brainstorm yet"

List Issues with Brainstorms

# Show all issues with existing brainstorm docs
for dir in brainstorming/issue-*/; do
  [ -d "$dir" ] || continue
  num=$(echo "$dir" | grep -oE '[0-9]+' | head -1)
  title=$(head -1 "$dir/notes.md" 2>/dev/null | sed 's/# //')
  echo "#$num: $title 📝"
done

Fetch Issues + Show Brainstorm Status

# Fetch open issues and mark those with brainstorms
REPO=$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')
curl -s "https://api.github.com/repos/$REPO/issues?state=open&per_page=20" | \
  jq -r '.[] | "#\(.number) \(.title)"' | \
  while read line; do
    num=$(echo "$line" | grep -oE '^#[0-9]+' | tr -d '#')
    if ls brainstorming/issue-$(printf '%03d' $num)-* 2>/dev/null | grep -q .; then
      echo "$line 📝"
    else
      echo "$line"
    fi
  done

Output example:

#29 Add Mistral code
#12 Create NPM package for quick global install 📝
#11 Build cloud integration
#4 Headless operation and logs collection 📝

View Brainstorm for Issue

ISSUE_NUM=12
cat brainstorming/issue-$(printf '%03d' $ISSUE_NUM)-*/notes.md 2>/dev/null || echo "No brainstorm for #$ISSUE_NUM"

References

• GitHub REST API - Issues
• GitHub API Rate Limiting
• Brainstorming Skill - Create brainstorm docs from issues

Converted and distributed by TomeVault — claim your Tome and manage your conversions.