TestFlight PM - GitHub Action

Intelligent TestFlight feedback processing with AI-powered issue enhancement and automated issue creation for GitHub and Linear.

✨ Features

🤖 AI-Enhanced Issues - Intelligent issue titles, descriptions, and categorization using OpenAI, Anthropic, or Google Gemini
📱 TestFlight Integration - Process crash reports and user feedback from TestFlight automatically
🎯 Multi-Platform - Create issues in GitHub Issues or Linear
🔄 Duplicate Prevention - Smart duplicate detection to avoid creating redundant issues
💰 Cost Controls - Built-in LLM usage tracking and spending limits

📋 What We Process

This action uses the App Store Connect API 4.0 (announced during WWDC25 Platforms State of the Union) to automatically process your TestFlight feedback:

🔥 Crash Reports - Stack traces, device info, and system state during crashes
📸 User Feedback - Screenshots, comments, and annotations from beta testers
🔍 Smart Analysis - AI-powered categorization and technical insights

🚀 Quick Setup

1. Set Up App Store Connect API Access

Create API Key in App Store Connect

Sign in to App Store Connect at appstoreconnect.apple.com
Navigate to API Keys:
- Click Users and Access in the top navigation
- Click Integrations tab
- Click App Store Connect API section
- Click the "+" button to create a new key
Configure API Key:
- Name: Give it a descriptive name (e.g., "TestFlight PM GitHub Action")
- Access: Select Developer role (minimum required for TestFlight feedback access)
- Click Generate
Download and Save:
- Download the .p8 file immediately (you can only download it once!)
- Copy the Key ID (shown after creation)
- Copy the Issuer ID (shown at the top of the API Keys page)

Find Your App ID

In App Store Connect, go to My Apps
Click on your app
Go to App Information (in the sidebar)
Your App ID is shown in the General Information section (a numeric ID like 1234567890)

Alternatively, you can use your Bundle ID (like com.yourcompany.yourapp) - this action supports both!

Add Secrets to GitHub

Go to your repository Settings → Secrets and variables → Actions and add:

TestFlight API Access (Required)

TESTFLIGHT_ISSUER_ID       # Issuer ID from App Store Connect API Keys page
TESTFLIGHT_KEY_ID          # Key ID from your generated API key  
TESTFLIGHT_PRIVATE_KEY     # Full content of the downloaded .p8 file
TESTFLIGHT_APP_ID          # Your numeric App ID (optional if using Bundle ID)
TESTFLIGHT_BUNDLE_ID       # Your app's Bundle ID (optional if using App ID)

💡 Pro Tip: You need either TESTFLIGHT_APP_ID OR TESTFLIGHT_BUNDLE_ID - the action will automatically resolve the App ID from your Bundle ID if needed.

Platform Secrets

For GitHub Issues:

GTHB_TOKEN                 # GitHub Personal Access Token with repo permissions

For Linear:

LINEAR_API_TOKEN           # Linear API Token
LINEAR_TEAM_ID             # Your Linear Team ID

AI Enhancement (Optional)

OPENAI_API_KEY             # OpenAI API key
ANTHROPIC_API_KEY          # Anthropic API key  
GOOGLE_API_KEY             # Google API key

2. Create Workflow File

Create .github/workflows/testflight-pm.yml:

name: TestFlight Feedback Processing

on:
  schedule:
    - cron: '0 * * * *'  # Every hour
  workflow_dispatch:

jobs:
  testflight-pm:
    runs-on: ubuntu-latest
    steps:
      - uses: vishrutkmr7/testflight-pm@latest
        with:
          # Required TestFlight Configuration
          testflight_issuer_id: ${{ secrets.TESTFLIGHT_ISSUER_ID }}
          testflight_key_id: ${{ secrets.TESTFLIGHT_KEY_ID }}
          testflight_private_key: ${{ secrets.TESTFLIGHT_PRIVATE_KEY }}
          # Use EITHER app_id OR testflight_bundle_id (action will resolve automatically)
          app_id: ${{ secrets.TESTFLIGHT_APP_ID }}                    # Option 1: Numeric App ID
          # testflight_bundle_id: ${{ secrets.TESTFLIGHT_BUNDLE_ID }} # Option 2: Bundle ID (com.company.app)
          
          # Platform Configuration
          platform: 'github'
          gthb_token: ${{ secrets.GTHB_TOKEN }}
          
          # Enhancement Features
          enable_llm_enhancement: 'true'
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

3. Run Your First Workflow

Go to Actions tab in your repository
Click on TestFlight Feedback Processing
Click Run workflow → Run workflow

That's it! The action will process your TestFlight feedback and create enhanced issues.

🔐 Security

Secure API Access: Uses App Store Connect API with proper JWT authentication
Private Key Safety: Your .p8 file is stored securely as a GitHub secret
Rate Limiting: Automatic throttling respects Apple's API limits
Minimal Permissions: Requires only Developer role access in App Store Connect

🤖 AI Enhancement Examples

Without AI Enhancement

Title: App Crash
Body: User reported app crashed when tapping login button
Labels: bug, crash, testflight

With AI Enhancement

Title: 💥 Authentication Crash - NSInvalidArgumentException in LoginViewController
Body: 
## Issue Summary
Critical authentication flow crash when user attempts login, likely due to null parameter validation failure.

## Technical Analysis
- **Exception Type:** NSInvalidArgumentException  
- **Component:** LoginViewController.signInButtonTapped
- **Severity:** High - Prevents app access

## Suggested Investigation Areas
- Check null validation for username/password fields
- Review AuthenticationManager error handling
- Validate network connectivity handling

## Code Areas
- `LoginViewController.swift:42-67` (0.95 confidence)
- `AuthenticationManager.swift:120-145` (0.87 confidence)

📋 Configuration Options

Core Required Inputs

Input	Required	Description
`testflight_issuer_id`	✅	App Store Connect API Issuer ID
`testflight_key_id`	✅	App Store Connect API Key ID
`testflight_private_key`	✅	App Store Connect private key (.p8 file content)
`app_id`	⚠️	TestFlight App ID (required if `testflight_bundle_id` not provided)
`testflight_bundle_id`	⚠️	App Bundle ID like `com.company.app` (required if `app_id` not provided)

💡 App Identification: You must provide either app_id OR testflight_bundle_id. The action will automatically resolve the App ID from your Bundle ID if needed.

Platform Options

Input	Default	Description
`platform`	`github`	Where to create issues: `github`, `linear`, or `both`
`gthb_token`	-	GitHub token (required for GitHub)
`linear_api_token`	-	Linear API token (required for Linear)
`linear_team_id`	-	Linear team ID (required for Linear)

AI Enhancement Options

Input	Default	Description
`enable_llm_enhancement`	`false`	Enable AI-powered issue enhancement
`llm_provider`	`openai`	Primary AI provider: `openai`, `anthropic`, `google`
`openai_api_key`	-	OpenAI API key
`anthropic_api_key`	-	Anthropic API key
`google_api_key`	-	Google API key
`max_llm_cost_per_run`	`2.00`	Maximum AI cost per workflow run (USD)

🔧 Examples

Multi-Platform Setup

- uses: vishrutkmr7/testflight-pm@latest
  with:
    # Required TestFlight Configuration
    testflight_issuer_id: ${{ secrets.TESTFLIGHT_ISSUER_ID }}
    testflight_key_id: ${{ secrets.TESTFLIGHT_KEY_ID }}
    testflight_private_key: ${{ secrets.TESTFLIGHT_PRIVATE_KEY }}
    # Example using Bundle ID instead of App ID
    testflight_bundle_id: ${{ secrets.TESTFLIGHT_BUNDLE_ID }}  # e.g., com.mycompany.myapp
    
    # Platform Configuration (both GitHub and Linear)
    platform: 'both'
    gthb_token: ${{ secrets.GTHB_TOKEN }}
    linear_api_token: ${{ secrets.LINEAR_API_TOKEN }}
    linear_team_id: ${{ secrets.LINEAR_TEAM_ID }}
    
    # Enhancement Features
    enable_llm_enhancement: 'true'
    enable_codebase_analysis: 'true'
    enable_duplicate_detection: 'true'
    
    # LLM Provider Configuration
    llm_provider: 'anthropic'
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

High-Frequency Processing

name: TestFlight Feedback Processing

on:
  schedule:
    - cron: '0 * * * *'  # Every hour
  workflow_dispatch:

jobs:
  testflight-pm:
    runs-on: ubuntu-latest
    steps:
      - uses: vishrutkmr7/testflight-pm@latest
        with:
          # Required TestFlight Configuration
          testflight_issuer_id: ${{ secrets.TESTFLIGHT_ISSUER_ID }}
          testflight_key_id: ${{ secrets.TESTFLIGHT_KEY_ID }}
          testflight_private_key: ${{ secrets.TESTFLIGHT_PRIVATE_KEY }}
          app_id: ${{ secrets.TESTFLIGHT_APP_ID }}
          
          # Platform Configuration
          platform: 'github'
          gthb_token: ${{ secrets.GTHB_TOKEN }}
          
          # Processing Configuration (process only last 2 hours to avoid duplicates)
          processing_window_hours: '2'
          
          # Enhancement Features
          enable_llm_enhancement: 'true'
          llm_provider: 'anthropic'
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

🧪 Testing

Test the action locally before deploying:

# Clone and test locally
git clone https://github.com/vishrutkmr7/testflight-pm
cd testflight-pm
./test-action-local.sh

Or test in GitHub Actions with dry run mode:

- uses: vishrutkmr7/testflight-pm@latest
  with:
    testflight_issuer_id: ${{ secrets.TESTFLIGHT_ISSUER_ID }}
    testflight_key_id: ${{ secrets.TESTFLIGHT_KEY_ID }}
    testflight_private_key: ${{ secrets.TESTFLIGHT_PRIVATE_KEY }}
    app_id: ${{ secrets.TESTFLIGHT_APP_ID }}
    platform: 'github'
    gthb_token: ${{ secrets.GTHB_TOKEN }}
    enable_llm_enhancement: 'true'
    llm_provider: 'anthropic'
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    dry_run: 'true'  # Won't create actual issues
    debug: 'true'    # Verbose logging

❓ Troubleshooting

TestFlight credentials invalid

Verify your Issuer ID, Key ID, and Private Key from App Store Connect API settings
Ensure your API key has Developer role permissions
Double-check the .p8 file content includes headers and footers

App not found

Confirm your App ID (numeric) or Bundle ID (com.company.app) is correct
Check that your API key can access the specific app

No issues created

Enable debug mode: debug: 'true' to see detailed logs
Verify there's new TestFlight feedback in the processing window

AI enhancement failed

Check your AI provider API key is valid and has sufficient credits
Verify cost limits aren't exceeded

Permission denied

GitHub: Ensure token has repo permissions
Linear: Verify API token has write access to your team

Getting Help

🐛 Report Issues
💬 Discussions

Name		Name	Last commit message	Last commit date
Latest commit History 68 Commits
.claude		.claude
.cursor/rules		.cursor/rules
dist		dist
src		src
types		types
.dockerignore		.dockerignore
.gitignore		.gitignore
Dockerfile		Dockerfile
README.md		README.md
action-entrypoint.ts		action-entrypoint.ts
action.yml		action.yml
bun.lock		bun.lock
package.json		package.json
tsconfig.json		tsconfig.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

TestFlight PM - GitHub Action

✨ Features

📋 What We Process

🚀 Quick Setup

1. Set Up App Store Connect API Access

Create API Key in App Store Connect

Find Your App ID

Add Secrets to GitHub

TestFlight API Access (Required)

Platform Secrets

AI Enhancement (Optional)

2. Create Workflow File

3. Run Your First Workflow

🔐 Security

🤖 AI Enhancement Examples

Without AI Enhancement

With AI Enhancement

📋 Configuration Options

Core Required Inputs

Platform Options

AI Enhancement Options

🔧 Examples

Multi-Platform Setup

High-Frequency Processing

🧪 Testing

❓ Troubleshooting

Getting Help

About

Uh oh!

Releases 16

Packages

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

TestFlight PM - GitHub Action

✨ Features

📋 What We Process

🚀 Quick Setup

1. Set Up App Store Connect API Access

Create API Key in App Store Connect

Find Your App ID

Add Secrets to GitHub

TestFlight API Access (Required)

Platform Secrets

AI Enhancement (Optional)

2. Create Workflow File

3. Run Your First Workflow

🔐 Security

🤖 AI Enhancement Examples

Without AI Enhancement

With AI Enhancement

📋 Configuration Options

Core Required Inputs

Platform Options

AI Enhancement Options

🔧 Examples

Multi-Platform Setup

High-Frequency Processing

🧪 Testing

❓ Troubleshooting

Getting Help

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases 16

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages