---
title: Map related issues and pull requests
description: Trace related issues and pull requests from your terminal, check review status, find existing fixes, and choose what to review next.
url: "https://issue-graph.dev/docs"
docs_index: /llms.txt
lastUpdated: "2026-09-27T00:00:00.000Z"
navTitle: "Overview"
canonical_url: "https://issue-graph.dev/docs"
---

# Map related issues and pull requests

> For an index of all documentation, see [/llms.txt](/llms.txt).

`issue-graph` is a CLI that traces the GitHub issues and pull requests linked to an item. Use it to find existing fixes, check review status, and decide what to review next.

## Install

You need Node.js 20 or later and the [GitHub CLI](https://cli.github.com).

```bash
npm install --global issue-graph@latest
gh auth login
```

To run the [npm package](https://www.npmjs.com/package/issue-graph) without installing it, use `npx issue-graph@latest --help`.

## Trace an issue

```bash
issue-graph graph vercel-labs/agent-browser#1113 --depth 1 --budget 12 --no-save
```

The report lists the linked issues and PRs, their current states, and possible follow-ups. To trace your own work, pass an issue URL or replace the repository and number.

See [Get started](/docs/get-started) for a walkthrough and example output.

## Commands

| Task                                      | Command                                   | Guide                                          |
| ----------------------------------------- | ----------------------------------------- | ---------------------------------------------- |
| Capture a backlog and open its dashboard  | `issue-graph open owner/repo`             | [Dashboard and saved queries](/docs/dashboard) |
| Trace linked issues and PRs               | `issue-graph graph <issue-or-pr>`         | [Graph](/docs/graph)                           |
| Rank a live backlog by Heat               | `issue-graph rank owner/repo`             | [Graph](/docs/graph)                           |
| Group related work with your agent        | `issue-graph cluster owner/repo`          | [Agents and skills](/docs/agents)              |
| Filter saved work and open its exact view | `issue-graph query provider:scope --open` | [Dashboard and saved queries](/docs/dashboard) |
| Read Linear issue relationships           | `issue-graph linear <issue>`              | [Linear](/docs/linear)                         |
| Count PRs by author and review state      | `issue-graph status`                      | [Status and history](/docs/status)             |
| Find backlog items to verify              | `issue-graph reconcile`                   | [Reconcile and plan](/docs/backlog)            |
| Choose the next review or investigation   | `issue-graph plan`                        | [Reconcile and plan](/docs/backlog)            |

`config` sets scoring defaults, `dashboard` and `runs` manage saved models, and `auth status` reports sign-in state. The [Command reference](/docs/reference) lists every command and flag.

## Use with agents and applications

Install the [agent skill](/docs/agents) to run issue-graph from a coding agent. The [library](/docs/library) exposes the same collectors and renderers to your application code. Most commands can also print JSON for scripts and agents.

## Review results

The CLI reads GitHub data and reports gaps caused by access errors or crawl limits. Check those gaps and inspect the linked code before you close an issue or merge a PR.

Graph and reconcile save local history by default. See [Permissions and privacy](/docs/security) for storage controls and the [Command reference](/docs/reference) for flags and output formats.

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)