Skip to content

ccheney/github-issue-dag-viewer

Repository files navigation

Issue Atlas

Issue Atlas turns native GitHub issue dependencies into an interactive directed graph. It shows ready and blocked work, dependency cycles, critical paths, and the upstream or downstream impact of a selected issue.

Open the hosted viewer

The included implementation blueprint works without a token. The viewer is read-only and can load any accessible github.com repository directly from the browser.

Use a GitHub repository

  1. Open Open repository.
  2. Enter owner/repository or a GitHub repository URL.
  3. Supply a fine-grained token with Issues read access.
  4. Choose Load repository.

GitHub GraphQL requires authentication for public and private repositories. Limit the token to the repositories you want to inspect with Issues: Read-only permission. Issue Atlas sends it only to https://api.github.com/graphql, keeps it in memory for the current tab, and never writes it to storage, URLs, logs, exports, source maps, or deployment artifacts. Refreshing or closing the tab discards it.

Run locally

Install the pinned Bun version from .tool-versions, then:

git clone https://github.com/ccheney/github-issue-dag-viewer.git
cd github-issue-dag-viewer
bun install --frozen-lockfile
bun run dev

Open the URL printed by Vite. Demo mode requires no additional setup.

Verify changes

Install Chromium once before running browser tests:

bunx playwright install chromium
Command Checks
bun run check Formatting, linting, and strict TypeScript
bun run test Unit and GitHub client contract tests
bun run test:e2e Desktop, mobile, and accessibility workflows
bun run build Production build and compressed bundle budgets
bun run verify The complete CI gate

Limits and documentation

Dependency connections are capped at 100 relationships per issue, cross-repository nodes contain partial metadata, and graph layout is gated above 1,000 issues. SVG and JSON remain available when a PNG export exceeds the measured limits.

License

MIT © 2026 Chris Cheney

About

Interactive GitHub issue dependency DAG and issue explorer

Topics

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors