Skip to content

feat(linear): read attached GitHub work with --github - #51

Merged
Railly merged 2 commits into
mainfrom
railly/linear-github-hop
Nov 8, 2026
Merged

Railly merged 2 commits into
mainfrom
railly/linear-github-hop

Conversation

@Railly

@Railly Railly commented Nov 8, 2026

Copy link
Copy Markdown
Member

Problem

  • issue-graph linear lists GitHub attachments without reading them, so a blocked issue can't show whether its blocker's PR is open, draft, or merged.
  • With the Linear MCP session, a relation read from both issues shows twice in the dashboard.
  • The bundled guide still says live Linear collection isn't available.

Changes

  • --github reads attached GitHub issues and PRs one hop through gh and records kind, state, draft, and title.
  • Markdown shows the blocker's linked work on the blocked issue: ← blocks: ENG-2 · acme/app#412 PR open, draft. The dashboard shows a state badge on each attachment.
  • An unreadable target stays visible as unavailable and marks its issue partial (exit 1). Without --github, no GitHub requests are made.
  • MCP relation ids come from the relation's endpoints, so one relation is one edge from either side.
  • Docs, --help, schema, and the bundled guide cover --github.

Limitations: GitHub targets aren't expanded, and GitHub to Linear links aren't read. Markdown still prints keys for unfetched neighbors (#50).

Visual proof

Before, main: the blocks relation shows twice and attachments have no state.

Before

After, with --github: one relation, and each attachment shows its GitHub state.

After

Linear attachments that point at GitHub issues or pull requests are read one hop through gh, so a blocked issue shows whether each blocker's linked work is open, draft, closed, or merged. Unreadable targets stay visible and mark the issue partial. The bundled guide no longer says live Linear collection is unavailable.
The MCP transport built relation ids from the reading issue, so a blocks or related relation read from both endpoints showed twice in the dashboard. Ids now come from the relation's endpoints.
@vercel

vercel Bot commented Nov 8, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
issue-graph Ready Ready Preview, v0 Nov 8, 2026 7:46am UTC

@Railly
Railly merged commit 50eeb8a into main Nov 8, 2026
12 checks passed
@Railly
Railly deleted the railly/linear-github-hop branch November 8, 2026 08:03

This branch was successfully deployed

1 active deployment
Preview — 924b58f5 Deployed Nov 8, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant