--- title: Changelog description: Release notes for issue-graph, covering agent guidance, CLI updates, and documentation. url: "https://issue-graph.dev/docs/changelog" docs_index: /llms.txt canonical_url: "https://issue-graph.dev/docs/changelog" --- # Changelog > For an index of all documentation, see [/llms.txt](/llms.txt). ## 0.6.1 ### Features - `issue-graph linear --github` reads the GitHub issues and pull requests attached to each Linear issue, one hop through `gh`. A blocked issue shows whether its blocker's linked work is open, draft, closed, or merged, and the dashboard shows the state on each attachment. Unreadable targets stay visible and mark the issue partial. ### Fixes - With the Linear MCP session, a relation read from both of its issues shows once in the dashboard instead of twice. ### Documentation - The bundled agent guide no longer says live Linear collection is unavailable. - Docs pages follow the technical-writer style, and the README hero shows clusters in light and dark themes. ## 0.6.0 ### Features - `issue-graph linear ` reads a Linear issue neighborhood: relations in both directions, parents, sub-issues, and attachment links, with native states and workspace-scoped identifiers. - `issue-graph linear --project UUID` captures a whole Linear project, including disconnected issues, and counts its open issues. - `issue-graph linear login` connects through the browser to Linear's read-only MCP server, with no API key or admin access. `LINEAR_API_KEY` or `LINEAR_ACCESS_TOKEN` also works and takes precedence. `linear status`, `linear logout`, and `auth status` show the connection. - Linear projects open in the dashboard next to saved GitHub runs, and `--cluster` with `--clusters` applies proposed themes. - When Linear rate limits a capture, the command waits if the window resets within the retry budget and otherwise stops with the reset time. - `--no-save` replaces `--no-snapshot`, which still works as a deprecated alias. - The dashboard uses Geist color tokens in light and dark themes, and the first 14 cluster colors come from the Geist hue scales. Larger graphs keep every cluster color distinct. ### Fixes - Provider logos in imported dashboard models must be static SVG shapes with allowlisted attributes, so an imported capture cannot run script in the dashboard. - Default dashboard exports are written to a new private temporary directory. Exports refuse asset paths through directories that another account owns or can write, including existing assets with open permissions. - `cluster --agent claude` runs Claude with no tools or MCP servers, and `cluster --agent codex` runs Codex in its read-only sandbox. Both start in an empty directory, and the prompt marks issue titles as untrusted data. ### Documentation - Add a Linear guide, and describe Linear in the README, the bundled agent guide, and `schema`. - The landing page shows agent-proposed clusters from a real capture, the GitHub and Linear providers, and Heat ranking with adjustable weights. - Shorten the README and move website and dashboard development notes to CONTRIBUTING. ## 0.5.0 ### Features - `plan` returns a `sweep` lane of open work one decision resolves together: an issue with several open closing PRs, a PR whose modified files are all gone from the default branch, and each PR paired with the PR it shares the most rarely edited files with. - Each sweep group names its next step: `verify` when every PR is stale, `choose` for competing PRs, and `compare` for overlaps. Groups to verify come first. - The dashboard adds a Sweep view with stale, competing, and shared-file tabs. The cleanup checklist is now its Checklist tab, and checklist items also appear on the matching group cards. ### Fixes - `open` keeps saved clusters and the cleanup list when a later run brings none: items still in the graph keep their cluster, new items land in Ungrouped, and items that left the graph drop out. - Saved dashboard models with malformed sweep groups are rejected on import. ### Documentation - The bundled agent guide adds a sweep workflow that verifies each group on the current release before drafting close comments. ## 0.4.1 ### Fixes - Include `open`, `rank`, `cluster`, `dashboard`, `runs`, and `auth` in `schema`, with formats, defaults, and local-write details. - Correct help for labeled issue discovery, crawl budgets, and opening saved dashboards. ### Documentation - Shorten the bundled agent guide while preserving coverage, privacy, scoring defaults, and exact dashboard links. - Document dashboard library APIs and align guides with current CLI behavior and public source access. - Refresh landing examples and enable site analytics. ## 0.4.0 ### Features - Collect a repository's open issues and pull requests with paginated discovery, a configurable node budget, and explicit coverage limits. - Use `open`, `graph`, `rank`, and `cluster` with repository, item, or URL scopes. Omit the repository inside a GitHub checkout to infer it from the remote. - Group work with the calling agent: `cluster` returns a task, and `cluster --apply` validates the answer and rebuilds the saved dashboard without another crawl. Use `--agent` for headless runs. - Explore linked work in Explore, Impact, Swarm, and Rank. Group Swarm by cluster, state, or item kind, and compare Heat, links, blast radius, or depth. - Filter across views by state, item kind, clusters, Heat thresholds or percentiles, closing PR links, review state, and search. - Run the same filters and scoring offline with `query`. Return an exact dashboard link, explore an immutable `--capture`, or replay frozen parameters with `--history`. - Save scoring defaults globally, per provider, or per project with `config`. Command overrides and dashboard sliders remain exploratory. - Browse saved projects with `dashboard`, manage their latest models with `runs`, and inspect GitHub sign-in with `auth status`. ### Improvements - Open the original dashboard design and animations as a static Next.js export, without a server. - Distinguish open issues, open PRs, merged PRs, closed items, and fetch errors with consistent colors and legends. Cluster colors identify groups while nodes retain their state colors. - Keep filters and relationship signals compact, preserve linked context, and animate Rank on entry. - Updated agent guidance covers queries, capabilities, coverage, scoped defaults, and returning the exact `viewUrl`. Refreshed the README workflow demo. ### Compatibility - Older flags remain available for one minor release and print their replacements. Prefer command scopes, `--budget`, `--no-save`, and `-o PATH`. - Keep exported HTML together with its sibling `_next/` directory and `font-LICENSE.txt`. - `ISSUE_GRAPH_HOME` now controls all local state, including config, captures, query history, saved dashboards, and graph/status/reconcile history. - Query and config support provider-scoped models. Live collection in this release remains GitHub-only. ## 0.3.2 ### Improvements - Monochrome Graph, PR status, and Backlog plan terminal views with bold/dim hierarchy, grouped states, and clearer next actions. - Compact status tables, readable UTC capture times, and width-aware wrapping that preserves identifiers, counts, uncertainty, and follow-up details. - Explicit `--format text` for Graph and Plan. Existing JSON/Markdown contracts remain unchanged, including piped defaults and Graph `--json PATH` exports. - Plain output in pipes and when `NO_COLOR`, `CI`, or `TERM=dumb` disables terminal styling. - Narrower docs examples with the same human-output hierarchy and natural title wrapping. ## 0.3.1 ### Improvements - Shorter, English-only agent skill descriptions and consistent core catalog metadata. - Static Graph, PR status, and Backlog demos with minimal command highlighting. - Updated README screenshot, product-first metadata, and Vercel icons. - Release notes available in the docs and GitHub Releases. --- For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md) For an index of all available documentation, see [/llms.txt](/llms.txt)