Add rate limit awareness for GitHub API calls

[Hell1213]

Description

The GitHubCLIProvider currently makes gh CLI calls without checking GitHub API rate limits. Add rate limit awareness:

1. Parse rate limit info from gh api rate_limit response
2. Before each API call, check remaining quota
3. If quota is low, warn the user or back off
4. Handle rate limit exceeded errors gracefully

Skills Required

• Python
• GitHub API
• Rate limiting strategies

Difficulty

Intermediate-level2,gssoc-ext

[basantnema31]

Hi! I am participating in GSSoC '26 and I would love to tackle this issue. Since there are no assignees yet, could you please assign it to me? Thank you!

[Jiya3177]

Hi @Hell1213,

I would like to work on this issue under GSSoC.

I reviewed the requirement and my planned approach is:

• Inspect the current GitHubCLIProvider implementation and identify where gh API calls are made
• Add a small rate-limit check using gh api rate_limit before GitHub API calls
• Parse the remaining quota, reset time, and relevant resource/core limit information
• Warn the user when the remaining quota is low instead of failing unexpectedly
• Handle rate-limit exceeded responses gracefully with a clear error message and reset-time guidance
• Keep the implementation lightweight and avoid changing unrelated provider behavior
• Add helper functions for rate-limit parsing/checking if that matches the current code structure
• Add or update tests if the repo already has provider/CLI tests
• Verify the CLI still works normally when quota is available

I will keep the PR focused only on GitHub API rate-limit awareness.

Please assign this issue to me if this approach looks good and it is still available.

[Hell1213]

@Jiya3177 yeah you can work on this issue. Looking forward to your contribution! Please don't forget to star our repo! 🌟

[github-actions]

Welcome back @Hell1213! Great to see you contributing again. 🌟

I've assigned this issue to you. Happy coding! If you have any questions, feel free to ask here.

---

Note: If you find this project helpful, please consider giving us a star! ⭐ Give a Star

[Jiya3177]

Hi @Hell1213,

I have submitted the PR for this issue:

PR: #54

Summary:

• Added rate-limit checks before gh api calls.
• Warns when remaining GitHub API quota is low.
• Handles exhausted rate limits with clear ProviderError messages.
• Added focused tests with mocked subprocess.run.

Please review it when you get a chance. Thank you!