Skip to main content
command CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/issue-to-linear-task.md
Open on GitHub

What 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.md

Call it with /issue-to-linear-task. For all projects use ~/.claude/commands/

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.

issue-to-linear-task davila7 issue-to-linear-task converts individual GitHub issues into Linear tasks while keeping comments, formatting, and issue links intact. Useful when migrating bug trackers or syncing items. CX Codex +1 127installs linear-task-to-issue davila7 linear-task-to-issue — a slash command that turns a Linear task into a GitHub issue, carrying over fields, links, attachments and comments. Useful when planning lives in Linear and code lives in GitHub. CX Codex +1 129installs implement-task-linear PinguApps implement-task-linear — a skill for Claude Code bundles multiple Linear issues into a single branch and pull request. It coordinates ticket states, incremental commits, and pre-PR reviews before merging. CX Codex +1 346installs Linear Automation Claude Office Skills Linear Automation automates Linear issue tracking, Git branch and PR syncing, and two-week cycle planning through project-mcp tools. CX Codex +1 4,800installs issue-triage davila7 issue-triage triages incoming GitHub and Linear tasks, computes priority scores, and routes issues to matching teams. CX Codex +1 276installs linear official Linear Linear issue tracker integration for Claude Code. Create issues, manage projects, update statuses, and search workspaces directly from the agent. ★ 47,914repo stars pr-link-issue getsentry pr-link-issue adds a GitHub issue and its linked Linear ticket to the current PR description. Use it when a pull request needs references to the work it addresses. CX Codex +1 1,400installs

From the same set112

The whole set →
deployment-engineer deployment-engineer — a Claude subagent that drafts CI/CD pipelines, container builds and cloud infrastructure, then hands over a deployment runbook. CX Codex ★ 1,357repo stars architecture-auditor architecture-auditor audits software structure, design patterns, and layer separation. Helps spot circular imports and god objects before major refactoring. CX Codex ★ 1,357repo stars prompt-engineer The prompt-engineer subagent for Claude Code designs prompts, agent workflows, and structured outputs. It helps clarify instructions and safety constraints. CX Codex ★ 1,357repo stars quickstart quickstart is a command that guides a first run of the skill builder, from task questions to a validated skill with examples. CX Codex +1 ★ 1,357repo stars ml-engineer The ml-engineer subagent designs and runs the full ML model lifecycle, from data pipelines to deployment and monitoring. Use it for production MLOps work. CX Codex ★ 1,357repo stars python-pro python-pro is a Claude Code subagent for Python refactoring, performance work, and complex features. It joins these coding tasks and includes tests with its changes. CX Codex ★ 1,357repo stars ai-engineer ai-engineer designs RAG pipelines, configures vector databases, and writes agent workflows for LLM applications. Built for developers adding AI features. CX Codex ★ 1,357repo stars project-health-check project-health-check is a Claude Code command that reviews Git activity, dependencies, security findings, and Linear task metrics in a project health report. It helps identify risks to investigate. CX Codex +1 ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open