Issue Finder CLI
A CLI with a skill that searches open GitHub issues and assesses them against your stack; the fix and pull request stay with Codex.
- 139 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The utility uses GitHub tokens and a paid model provider key.
- On request Codex can change third-party code and open pull requests in your name.
Install
- Works in
Manual install
cargo install issue-finder --lockedPublished crate install command from the README. The skill is linked separately from `skills/issue-finder-cli`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The utility uses GitHub tokens and a paid model provider key.
- On request Codex can change third-party code and open pull requests in your name.
This is third-party code. Review the repository files before installing.
What it does
Issue Finder is a Rust `issue-finder` utility plus an `issue-finder-cli` skill for Codex. The utility exposes two tools: `scout` searches and ranks issues using a GitHub query and an interest profile, `assess` collects evidence for a chosen task. During `scout` a small model answers seven fixed questions about each task before final selection. Codex then takes over: it prepares a workspace, reproduces the bug, fixes it, validates and, with permission, opens a pull request. No separate MCP server is needed. The model provider is set in `[decision].provider`: Alibaba, Cloudflare or a `codex` fallback, with no silent switching.
Who it is for. Developers who want to contribute to open source and look for issues matching their stack. Needs Codex, a GitHub token and a model provider key.
Good fit when
- Five fresh Rust issues for CLI tools are wanted.
- Before work, a check that the issue is still open and unclaimed.
- A link to an issue is given, to be assessed and taken to a pull request.
- A shortlist across several projects without searching GitHub by hand.
Not a fit when
- Your own team's task tracker is needed, not a search over other repositories.
- There is no model provider key and `scout` does not work without one.
- Automatic pull requests to other projects without your decision.
Example request
Use the issue-finder-cli skill and recommend five issues for my Rust and developer-tools stack, without changes.Limitations
Needs Git, a compatible `issue-finder` binary with `sessionContractVersion: 2` and provider credentials: `DASHSCOPE_API_KEY` and an endpoint for Alibaba, a token and account ID for Cloudflare. For GitHub use `GH_TOKEN`; `GITHUB_TOKEN` is not read. Paid model calls are billed by the provider. Task text on GitHub is treated as data, not instructions. The skill does not replace human judgment: the user chooses what to fix and send as a pull request.
How to disable. Remove the link or the `issue-finder-cli` folder from `.agents/skills` or `~/.agents/skills`, then run `cargo uninstall issue-finder`. Delete state in `~/.issue-finder` by hand.
FAQ
Which tools does the utility have?
Two: `issue-finder.scout` for search and ranking and `issue-finder.assess` for evaluating a chosen task. Codex does the rest.
Is an MCP server needed?
No. The skill calls the utility with `issue-finder tools call` and no dispatcher setup is required.
Which variable does GitHub need?
`GH_TOKEN`. The utility does not read `GITHUB_TOKEN`; without a token it falls back to a stored `gh` login.
How do I verify the install?
Run `issue-finder tools --profile session list` and `issue-finder decision-check`. The catalog must report contract version 2.
What does Codex do after a task is chosen?
It prepares a workspace, reproduces the bug, fixes it, validates and opens a pull request if you allowed it. The utility only supplies search and evidence.
Discussion
No questions or reviews yet.
Related
CLI toolsCLI and GitHub Action that triages issues, reviews pull requests and drafts release notes with code references.
Codex Settings skills
Codex CLI Skills & Profiles
A Codex CLI plugin with twelve skills: deep research, pull request review, image generation and session handoff
61 small skills for Codex across 13 areas: codebase orientation, tests, migrations, security, CI and pull request review
Codex MCP Tool (cexll)
Codex MCP Tool
An MCP server that sends tasks to Codex CLI from Claude Code and Cursor: code review via @ refs, a sandbox, patch edits, ideas
A Codex skill for repository health audits covering tests, CI, dependencies, security signals and tech debt, with evidence.
Awesome Codex Skills
awesome-codex-skills
A set of practical skills for Codex CLI and API from the Composio community: error triage, research, changelogs, CI fixes
README in short
The skill is limited to search and assessment through `scout` and `assess`. Fixing, validation and the pull request stay with the main agent session.