IssueScope is a tool for triaging GitHub issues using AI. It analyzes issues to determine their implementation difficulty, required skills, and overall doability, helping contributors find the right issues to work on.
- AI Analysis: Automatically analyzes issues to estimate complexity, required skills, and newcomer friendliness.
- Doability Scoring: Ranks issues based on a calculated score (0-100) indicating how actionable and feasible they are.
- Parallel Processing: Fetches issue details and performs AI analysis in parallel for high throughput.
- Rich Markdown Support: Renders issue bodies and comments with full Markdown and HTML image support.
- Keyboard Navigation: Vim-style navigation (j/k, gg, G) and keyboard shortcuts for efficiency.
- Local Privacy: API keys are stored in memory and never sent to a backend server.
-
Clone the repository:
git clone https://github.com/vee1e/isscope.git cd isscope -
Install dependencies:
bun install
-
Start the development server:
bun dev
The application requires API keys to function. You can configure these directly in the UI upon launching the application.
- OpenRouter API Key: Required for AI analysis.
- GitHub Token: Optional, but recommended for higher API rate limits.
- Enter a GitHub repository (e.g.,
owner/repo) or a full URL in the input field. - Click "Configure API Keys" to enter your credentials if you haven't already.
- Start the analysis.
- Browse the ranked list of issues.
- Select an issue to view its full details, including the AI-generated summary and implementation advice.
Contributions are welcome. Please follow these steps:
- Fork the repository.
- Create time a feature branch (
git checkout -b feature/amazing-feature). - Commit your changes (
git commit -m 'Add some amazing feature'). - Push to the branch (
git push origin feature/amazing-feature). - Open a Pull Request.
Please ensure your code follows the existing style and conventions.
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.