How shrivishalcr-wq/github-contribution-repo-finder works
This terminal agent turns a developer’s skills and preferences into ranked GitHub contribution recommendations. Its main workflow clarifies and extracts a profile, searches for repositories, inspects repository details and issues, then deterministically ranks candidates and presents results with an optional AI summary. Session memory preserves preferences across turns; GitHub response caching and centralized configuration support the runtime. The README and excerpts establish the orchestration and major capabilities; unsampled implementation details are represented only where documented, and edges are limited to shown calls or documented relationships.
Main entry points: agent.py Turn orchestrator · llm_client.py OpenRouter client · tools.py Tool specifications · github_client.py Repository search
Components 19
User interaction
- Terminal CLI
main.py - Recommendations
tool_executor.py
Agent orchestration
- Turn orchestrator
agent.py - Profile clarification
llm_client.py - Preference extraction
llm_client.py - Candidate assembly
tool_executor.py - Deterministic ranking
ranking.py
Repository discovery
- Tool specifications
tools.py - Tool dispatch and state
tool_executor.py - Repository search
github_client.py - Repository inspection
github_client.py - Issue discovery
github_client.py
Runtime support
- Session memory
memory.py - OpenRouter client
llm_client.py - API response cache
github_client.py - Runtime configuration
config.py
Other components
- Developer
- OpenRouter API
- GitHub REST API
Connections 28
- Developer → Terminal CLI: enters request
README.md - Terminal CLI → Turn orchestrator: delegates turn
main.py - Terminal CLI → Session memory: initializes session
main.py - Turn orchestrator → Profile clarification: checks profile
agent.py - Turn orchestrator → Preference extraction: extracts preferences
agent.py - Turn orchestrator → Session memory: reads and updates
agent.py - Turn orchestrator → OpenRouter client: requests completions
agent.py - Profile clarification → OpenRouter client: uses chat requests
llm_client.py - Preference extraction → OpenRouter client: uses chat requests
llm_client.py - OpenRouter client → OpenRouter API: sends requests
llm_client.py - Turn orchestrator → Tool specifications: provides tool specs
agent.py - Turn orchestrator → Tool dispatch and state: executes tool calls
agent.py - Tool dispatch and state → Tool specifications: dispatches allow-listed
tool_executor.py - Tool specifications → Repository search: dispatches search
tools.py - Tool specifications → Repository inspection: dispatches inspection
tools.py - Tool specifications → Issue discovery: dispatches issue lookup
tools.py - Repository search → GitHub REST API: queries repositories
github_client.py - Repository inspection → GitHub REST API: fetches metadata
github_client.py - Issue discovery → GitHub REST API: fetches open issues
github_client.py - Repository search → API response cache: uses response cache
github_client.py - Repository inspection → API response cache: uses response cache
github_client.py - Issue discovery → API response cache: uses response cache
github_client.py - Turn orchestrator → Candidate assembly: builds candidates
agent.py - Turn orchestrator → Deterministic ranking: ranks candidates
agent.py - Turn orchestrator → Recommendations: prints results
agent.py - Turn orchestrator → OpenRouter client: generates summary
agent.py - OpenRouter client → Runtime configuration: reads API settings
llm_client.py - Repository search → Runtime configuration: reads API settings
github_client.py