AI-powered GitHub Issue assistant that provides intelligent responses based on repository content using various AI models (OpenAI GPT-4, Anthropic Claude).
- 🤖 Automated issue analysis
- 🔍 Deep repository content understanding
- 📝 Markdown-formatted responses
- 🔄 Retry mechanism for reliability
- 📊 Confidence scoring
- 🚀 Docker support
- 🧠 Multiple AI model support (OpenAI, Claude)
- 📋 Customizable response templates
- Add this workflow to your repository (
.github/workflows/issue-assistant.yml):
name: Issue Assistant on: issues: types: [opened] jobs: analyze: runs-on: ubuntu-latest permissions: issues: write contents: read steps: - uses: workflowkit/[email protected] with: github_token: ${{ secrets.GITHUB_TOKEN }} ai_type: "openai" # or "claude" openai_api_key: ${{ secrets.OPENAI_API_KEY }} # claude_api_key: ${{ secrets.CLAUDE_API_KEY }} # if using claude enable_comment: "true" # required: at least one feature must be enabled enable_label: "false" # required: at least one feature must be enabled
- Add required secrets to your repository:
OPENAI_API_KEY(if using OpenAI)CLAUDE_API_KEY(if using Claude)
That's it! Now when someone opens an issue:
- AI will analyze the issue content
- AI will analyze your repository code
- AI will post a helpful response as a comment
- Optionally, AI can suggest labels
| Option | Description | Required | Default |
|---|---|---|---|
github_token |
GitHub token (automatically provided) | Yes | - |
ai_type |
AI model to use (openai or claude) |
Yes | - |
openai_api_key |
OpenAI API Key | Yes* | - |
claude_api_key |
Claude API Key | Yes* | - |
enable_comment |
Enable AI comments on issues | Yes** | false |
enable_label |
Enable AI label suggestions | Yes** | false |
*Either openai_api_key or claude_api_key is required based on ai_type
**At least one feature (enable_comment or enable_label) must be enabled
- uses: workflowkit/[email protected] with: github_token: ${{ secrets.GITHUB_TOKEN }} ai_type: "openai" openai_api_key: ${{ secrets.OPENAI_API_KEY }} enable_comment: "true"
- uses: workflowkit/[email protected] with: github_token: ${{ secrets.GITHUB_TOKEN }} ai_type: "claude" claude_api_key: ${{ secrets.CLAUDE_API_KEY }} enable_label: "true"
- uses: workflowkit/[email protected] with: github_token: ${{ secrets.GITHUB_TOKEN }} ai_type: "openai" openai_api_key: ${{ secrets.OPENAI_API_KEY }} enable_comment: "true" enable_label: "true"
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request