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
CLI

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.
All reasons and checks

lifuyue/issue-finder

Install

Works in

Manual install

cargo install issue-finder --locked

Published crate install command from the README. The skill is linked separately from `skills/issue-finder-cli`.

Access and checks

How we review

Extended 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.

CLI tools

CLI and GitHub Action that triages issues, reviews pull requests and drafts release notes with code references.

CLIExtended access83Repository stars

Codex Settings skills

Codex CLI Skills & Profiles

A Codex CLI plugin with twelve skills: deep research, pull request review, image generation and session handoff

PluginBroad access249Repository stars

61 small skills for Codex across 13 areas: codebase orientation, tests, migrations, security, CI and pull request review

SkillMinimal access169Repository stars
Needs a VPN

An MCP server that sends tasks to Codex CLI from Claude Code and Cursor: code review via @ refs, a sandbox, patch edits, ideas

MCP serverBroad access176Repository stars

A Codex skill for repository health audits covering tests, CI, dependencies, security signals and tech debt, with evidence.

SkillMinimal access155Repository stars

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

SkillExtended access17.3KRepository stars

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.

README badge

Report a problem