# issue-to-linear-task

issue-to-linear-task exports individual GitHub issues into Linear tasks while keeping descriptions, comment threads, milestones, and assignees intact.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/commands/sync/issue-to-linear-task.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/qdhenry-issue-to-linear-task

## What it does

This command queries ticket details using the `gh` CLI in JSON format. It retrieves the issue description, check lists, embedded images, author details, and associated discussion threads. Then it determines task priority from labels or keywords and maps the milestone to a target Linear project.

Claude displays a preview card asking for confirmation before creating anything in Linear. Once approved, it links the two records, leaves a cross-reference comment on GitHub, and can optionally close the original issue.

The command requires an active GitHub CLI (`gh`) session on your machine. Without `gh` configured in your environment, the issue retrieval step fails immediately.

## Requirements
- Works with: Linear

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/issue-to-linear-task.md` — Call it with /issue-to-linear-task. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/issue-to-linear-task.md` — Call it with /prompts:issue-to-linear-task. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/issue-to-linear-task.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/issue-to-linear-task.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/commands/sync/issue-to-linear-task.md

## When to use it
- migrate an issue from GitHub to a Linear board
- import issue discussion threads into Linear task comments
- map GitHub labels and titles to Linear task priorities
- link GitHub issue references to Linear projects

## Example prompts
- Convert issue 42 to Linear using issue-to-linear-task
- Run issue-to-linear-task 123 --team="backend" to assign it directly
- Migrate issue 77 with issue-to-linear-task and close it on GitHub

## Similar
- [linear-task-to-issue](https://affpapa.org/en/nevibecode/commands/linear-task-to-issue.md) — command · 129 installs
- [implement-task-linear](https://affpapa.org/en/nevibecode/skills/implement-task-linear.md) — skill · 346 installs
- [Linear Automation](https://affpapa.org/en/nevibecode/skills/linear-automation.md) — skill · 4800 installs
- [issue-triage](https://affpapa.org/en/nevibecode/commands/issue-triage.md) — command · 276 installs
- [linear](https://affpapa.org/en/nevibecode/plugins/linear.md) — plugin · ★ 47914 repo stars
- [pr-link-issue](https://affpapa.org/en/nevibecode/skills/pr-link-issue.md) — skill · 1400 installs

## Other versions with the same name
- [issue-to-linear-task · davila7](https://affpapa.org/en/nevibecode/commands/issue-to-linear-task.md) — 127 installs

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
