Skip to content

Home

Jump to bottom
Abid Ali Awan edited this page Dec 2, 2025 · 2 revisions

Issue Analyzer Wiki

Welcome to the Issue Analyzer wiki! This tool leverages AI to automatically analyze GitHub issues and generate detailed execution plans for resolving them.

Issue Analyzer License Python

Overview

Issue Analyzer is a sophisticated tool that combines:

  • GPT-5.1 Codex for advanced code analysis
  • OpenAI Agents for intelligent workflow orchestration
  • GitHub CLI for repository access
  • Firecrawl for external documentation research

The tool reads a GitHub issue, intelligently explores relevant parts of the codebase, and generates a comprehensive, actionable execution plan that any mid-level developer can follow.

Key Features

Feature Description
Intelligent Issue Analysis AI reads and understands GitHub issues automatically
Real-Time Streaming Watch the AI agent work with live progress updates
Tool Call Tracking See exactly which tools are being used
Reasoning Display Observe the agent's decision-making process
Smart Code Exploration Targeted analysis of relevant files only
External Research Integrated web scraping for documentation
Cost-Optimized Selective file inspection to minimize API costs
Structured Output Professional markdown execution plans

Quick Links

Page Description
Getting Started Installation, prerequisites, and your first run
Architecture and Tools Deep dive into system design and components

How It Works

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  GitHub Issue   │────▶│  AI Planner     │────▶│ Execution Plan  │
│  (Input)        │     │  Agent          │     │ (Output)        │
└─────────────────┘     └────────┬────────┘     └─────────────────┘
                                 │
                    ┌────────────┼────────────┐
                    ▼            ▼            ▼
              ┌──────────┐ ┌──────────┐ ┌──────────┐
              │ GitHub   │ │ Code     │ │ Firecrawl│
              │ CLI      │ │ Analysis │ │ Research │
              └──────────┘ └──────────┘ └──────────┘

Example Output

When you run Issue Analyzer, you'll see real-time output like:

🔍 Analyzing owner/repo#123...

💭 Reasoning: I need to understand the issue first...

[1] 🔧 Calling: get_github_issue → owner/repo#123...

💭 Reasoning: Based on the issue, I should explore the src/ directory...

[2] 🔧 Calling: list_repo_files_gh → ext=['.py'], paths=['src/']...

[3] 🔧 Calling: get_repo_file_gh → src/main.py...

[Execution plan streams in real-time...]

---
📊 Tools used (5): get_github_issue, list_repo_files_gh, get_repo_file_gh, firecrawl_search, firecrawl_scrape

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

Contributing

Contributions are welcome! Feel free to:

  • Open issues for bugs or feature requests
  • Submit pull requests
  • Improve documentation

Support

Clone this wiki locally