AutoDev GitHub Agent Action

🤖 Automated GitHub issue analysis using AI-powered code analysis. This action automatically analyzes GitHub issues when they are created or updated, providing intelligent insights and recommendations.

Features

• 🔍 Intelligent Issue Analysis: AI-powered analysis of GitHub issues with code context
• 💬 Automated Comments: Automatically add analysis results as comments to issues
• 🏷️ Smart Labeling: Automatically apply relevant labels based on analysis
• 🌐 Webhook Support: Standalone webhook server for real-time issue processing
• ⚙️ Configurable: Flexible configuration options for different workflows
• 🔗 Integration Ready: Built on top of the proven AutoDev GitHub Agent

Quick Start

GitHub Actions Usage

Add this action to your workflow file (e.g., .github/workflows/issue-analysis.yml):

name: Analyze Issues
on:
  issues:
    types: [opened, edited]

jobs:
  analyze:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
      
      - name: Analyze Issue
        uses: ./packages/github-agent-action
        with:
          github-token: ${{ secrets.GITHUB_TOKEN }}
          analysis-depth: medium
          auto-comment: true
          auto-label: true

Standalone Webhook Server

# Install dependencies
npm install

# Set environment variables
export GITHUB_TOKEN="your-github-token"
export WEBHOOK_SECRET="your-webhook-secret"

# Start the server
npx autodev-github-action server --port 3000

CLI Usage

# Analyze a specific issue
npx autodev-github-action analyze \
  --owner unit-mesh \
  --repo autodev-workbench \
  --issue 81 \
  --depth deep

# Start webhook server
npx autodev-github-action server --port 3000

# Validate configuration
npx autodev-github-action validate

Configuration

Action Inputs

| Input | Description | Default | Required | |-------|-------------|---------|----------| | github-token | GitHub token for API access | ${{ github.token }} | Yes | | workspace-path | Path to repository workspace | ${{ github.workspace }} | No | | analysis-depth | Analysis depth (shallow/medium/deep) | medium | No | | auto-comment | Add analysis comment to issues | true | No | | auto-label | Add labels based on analysis | true | No | | trigger-events | Events that trigger analysis | opened,edited,reopened | No | | exclude-labels | Labels to exclude from analysis | | No | | `include-labels` | Labels to include for analysis | | No |

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | GITHUB_TOKEN | GitHub personal access token | Required | | WEBHOOK_SECRET | Secret for webhook verification | Optional | | WORKSPACE_PATH | Repository workspace path | process.cwd() | | AUTO_COMMENT | Auto-add comments | true | | AUTO_LABEL | Auto-add labels | true | | ANALYSIS_DEPTH | Analysis depth | medium | | TRIGGER_EVENTS | Trigger events | opened,edited,reopened | | EXCLUDE_LABELS | Exclude labels | | | `INCLUDE_LABELS` | Include labels | |

Analysis Depths

Shallow

• Quick analysis focusing on obvious patterns
• Fast execution (< 30 seconds)
• Basic code references
• Suitable for high-volume repositories

Medium (Default)

• Balanced analysis with meaningful insights
• Moderate execution time (30-60 seconds)
• Comprehensive code exploration
• Good for most use cases

Deep

• In-depth analysis including dependencies
• Longer execution time (60-120 seconds)
• Architectural pattern analysis
• Best for complex issues

Examples

Basic Issue Analysis

- name: Analyze Issues
  uses: ./packages/github-agent-action
  with:
    github-token: ${{ secrets.GITHUB_TOKEN }}

Advanced Configuration

- name: Advanced Issue Analysis
  uses: ./packages/github-agent-action
  with:
    github-token: ${{ secrets.GITHUB_TOKEN }}
    analysis-depth: deep
    auto-comment: true
    auto-label: true
    exclude-labels: 'wontfix,duplicate'
    include-labels: 'bug,enhancement'

Webhook Server Setup

const { startWebhookServer } = require('@autodev/github-agent-action');

const server = await startWebhookServer({
  port: 3000,
  webhookSecret: process.env.WEBHOOK_SECRET,
  githubToken: process.env.GITHUB_TOKEN
});

API Reference

GitHubActionService

Main service class for processing issues.

const service = new GitHubActionService({
  githubToken: 'your-token',
  workspacePath: '/path/to/repo',
  autoComment: true,
  autoLabel: true
});

const result = await service.processIssue({
  owner: 'unit-mesh',
  repo: 'autodev-workbench',
  issueNumber: 81
});

IssueAnalyzer

Core analysis engine.

const analyzer = new IssueAnalyzer(context);
const result = await analyzer.analyzeIssue({
  depth: 'medium',
  includeCodeSearch: true,
  includeSymbolAnalysis: true
});

WebhookHandler

Webhook server for real-time processing.

const handler = new WebhookHandler(actionService, {
  port: 3000,
  secret: 'webhook-secret',
  onIssueOpened: async (payload) => {
    console.log('Issue opened:', payload.issue.number);
  }
});

await handler.start();

Development

Setup

# Clone the repository
git clone https://github.com/unit-mesh/autodev-worker.git
cd autodev-worker/packages/github-agent-action

# Install dependencies
pnpm install

# Build the package
pnpm run build

# Run tests
pnpm test

Project Structure

packages/github-agent-action/
├── src/
│   ├── action.ts           # Main action service
│   ├── issue-analyzer.ts   # Issue analysis logic
│   ├── webhook-handler.ts  # Webhook server
│   ├── types/             # Type definitions
│   └── index.ts           # Main entry point
├── bin/
│   └── action.js          # CLI entry point
├── action.yml             # GitHub Action definition
├── package.json
└── README.md

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

License

MIT License - see LICENSE for details.

Related Projects

• AutoDev GitHub Agent - Core analysis engine
• AutoDev Context Worker - Code context analysis
• AutoDev Worker Core - Core utilities

Support

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discussions