# linear-task-to-issue

linear-task-to-issue exports Linear tasks into GitHub issues while preserving descriptions, child tasks, comments, and priority labels.

- 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/linear-task-to-issue.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-linear-task-to-issue

## What it does

This command queries the Linear API for task details, sub-tasks, attachments, and thread discussions. It assembles this context into structured markdown and calls the `gh` CLI to publish the new issue on GitHub.

Linear workflow states turn into labels like `status/in-progress`. Closed tasks resolve immediately. Priority levels translate to `priority/*` tags with visual indicators, while team member assignments rely on an email-to-handle mapping table.

You need an authenticated `gh` CLI environment with repository access. If a user mapping is missing, the command creates the issue without an assignee. Once published, it writes the resulting GitHub issue link back into the original Linear card.

## Requirements
- Works with: Linear

## Install

### Claude Code (native platform)

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

### Codex

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

### GitHub Copilot

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

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/linear-task-to-issue.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/linear-task-to-issue.md

## When to use it
- migrate a Linear task directly into a GitHub issue
- preserve task relationships and checklists for sub-tasks
- import conversation comments with author timestamps
- map Linear states and priorities to GitHub issue labels

## Example prompts
- Convert Linear task ABC-123 into a GitHub issue in this repository
- Transfer task ABC-123 to owner/repo without bringing over comments
- Migrate all sprint tasks from Linear and link them back

## Similar
- [issue-to-linear-task](https://affpapa.org/en/nevibecode/commands/issue-to-linear-task.md) — command · 127 installs
- [bulk-import-issues](https://affpapa.org/en/nevibecode/commands/bulk-import-issues.md) — command · 129 installs
- [implement-task-linear](https://affpapa.org/en/nevibecode/skills/implement-task-linear.md) — skill · 346 installs
- [c-linear](https://affpapa.org/en/nevibecode/skills/c-linear.md) — skill · ★ 179 repo stars
- [orca-linear](https://affpapa.org/en/nevibecode/skills/orca-linear.md) — skill · 29900 installs
- [Linear Automation](https://affpapa.org/en/nevibecode/skills/linear-automation.md) — skill · 4800 installs

## Other versions with the same name
- [linear-task-to-issue · davila7](https://affpapa.org/en/nevibecode/commands/linear-task-to-issue.md) — 129 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
