issue-to-linear-task · qdhenry — Claude Code command: what it does and setup
issue-to-linear-task exports individual GitHub issues into Linear tasks while keeping descriptions, comment threads, milestones, and assignees intact.
no license ★ 1,357 updated 2026-03-01
.claude/commands/issue-to-linear-task.mdWhat issue-to-linear-task 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.
What it helps with
- 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 for the agent
- 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
How to install issue-to-linear-task
Manually: put the files in place
.claude/commands/issue-to-linear-task.mdCall it with /issue-to-linear-task. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/issue-to-linear-task.mdCall it with /prompts:issue-to-linear-task. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/issue-to-linear-task.prompt.mdManually: put the files in place
.gemini/commands/issue-to-linear-task.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about issue-to-linear-task
How to install issue-to-linear-task in Claude Code?
Save the prompt file to .claude/commands/issue-to-linear-task.md in your project folder.
What does issue-to-linear-task do?
It reads an issue via the GitHub CLI, builds a formatted Linear task representation, transfers comments, and generates the new Linear issue.
What external tools are required?
You need the gh command-line tool logged into your GitHub account so the prompt can pull ticket metadata.
Similar slash commands
All slash commands for Git and GitHub →issue-to-linear-task by other authors comes first.