---
title: Overview
description: Find related issues, check pull request status, and plan backlog reviews from your terminal.
url: "https://issue-graph.dev/docs"
docs_index: /llms.txt
lastUpdated: "2026-09-23T00:00:00.000Z"
canonical_url: "https://issue-graph.dev/docs"
---

# Overview

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

`issue-graph` is a CLI for tracing related GitHub issues and pull requests. Use it to find existing fixes, check review status, and choose what to review next.

## Install

Requires Node.js 20+ and [GitHub CLI](https://cli.github.com).

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

You can also try the [npm package](https://www.npmjs.com/package/issue-graph) with `npx issue-graph@latest --help`.

## Trace an issue

```bash
issue-graph 1113 --repo vercel-labs/agent-browser --depth 1 --max-nodes 12 --no-snapshot
```

The result shows linked issues and PRs, their current states, and possible follow-ups. Use an issue URL or replace the repository and number with your own.

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

## Commands

| Task                                    | Command                     | Guide                               |
| --------------------------------------- | --------------------------- | ----------------------------------- |
| Trace linked issues and PRs             | `issue-graph <issue-or-pr>` | [Graph](/docs/graph)                |
| 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) |

## Use with agents and applications

Install the [agent skill](/docs/agents) to use issue-graph from a coding agent. The [library](/docs/library) exposes the same collectors and renderers for your application. Both support structured results.

## 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 closing an issue or merging a PR.

Graph and reconcile save local history by default. See [Permissions and privacy](/docs/security) for storage controls and [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)