linear-task-to-issue · qdhenry — Claude Code command: how to install and use
linear-task-to-issue exports Linear tasks into GitHub issues while preserving descriptions, child tasks, comments, and priority labels.
no license ★ 1,357 updated 2026-03-01
.claude/commands/linear-task-to-issue.mdWhat linear-task-to-issue 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.
What it helps with
- 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 for the agent
- 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
How to install linear-task-to-issue
Manually: put the files in place
.claude/commands/linear-task-to-issue.mdCall it with /linear-task-to-issue. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/linear-task-to-issue.mdCall it with /prompts:linear-task-to-issue. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/linear-task-to-issue.prompt.mdManually: put the files in place
.gemini/commands/linear-task-to-issue.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about linear-task-to-issue
How do I install linear-task-to-issue in Claude Code?
Save the command markdown file to .claude/commands/linear-task-to-issue.md inside your project root.
What does linear-task-to-issue do?
It pulls a task from Linear via API, generates a matching GitHub issue via the gh tool, copies comments, and posts the cross-reference back.
What happens if an assignee has no matching GitHub account?
The issue is created without an assignee, and Claude logs a warning noting the missing GitHub handle.
Similar slash commands
All slash commands for Notes, tasks and projects →linear-task-to-issue by other authors comes first.