lifuyue/issue-finder

Issue Finder is a command-line tool written in Rust that helps developers who use AI coding assistants (referred to here as coding agents) find GitHub issues that are good candidates for those agents to work on. The tool does three things: it scouts a repository for issues worth delegating, gathers the local context an agent would need to tackle one, and produces a structured handoff package. It deliberately stops before making any code changes itself. The typical workflow involves three commands. The scout command searches for candidate issues and returns a ranked list. The prepare command takes a specific issue and assembles relevant context from the repository locally. The handoff command outputs the prepared package in a format ready for an agent to consume. All state is stored on the local machine under a configurable directory. Beyond direct command-line use, Issue Finder also exposes a JSON tool contract so that coding agents can call its functions programmatically. This means an agent can use Issue Finder as a tool during its own workflow, asking it to scout or prepare issues as part of a larger automated process. The tool is installed via Cargo, Rust's package manager, and requires a GitHub personal access token to query the GitHub API. The README is brief and links to separate documentation pages covering the usage guide, the agent-safe preparation system, and safe probes. The project is MIT licensed.