Skip to main content
command CX Codex

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

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

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

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

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.

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 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 bulk-import-issues davila7 bulk-import-issues — a Claude Code command that moves GitHub issues into Linear in bulk. You run it with flags for state, labels, milestones and batch size. 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 c-linear daxaur c-linear is a Claude Code skill that manages Linear issues through the linear CLI, starts linked branches, and opens linked PRs. Run linear auth first. CX Codex +1 ★ 179repo stars orca-linear stablyai The orca-linear Claude Code skill handles Linear tickets through the Orca CLI. It activates for linked issues, ticket searches, workflow changes, and completion updates. CX Codex +1 29,900installs 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

From the same set112

The whole set →
legacy-modernizer legacy-modernizer is a Claude Code subagent for planning and carrying out gradual changes to legacy systems. It engages on framework upgrades, codebase refactors, and monolith decomposition. CX Codex ★ 1,357repo stars todo-worktree todo-worktree takes tasks from a todo list and implements them inside isolated git worktrees with strict phased approvals. CX Codex +1 ★ 1,357repo stars package-skill package-skill is a Claude Code command that checks a skill and builds a ZIP for sharing, team distribution, or publication. CX Codex +1 ★ 1,357repo stars parallel-tasks-help parallel-tasks-help is a Claude Code command that explains how to run /parallel-tasks, with its options, agent types, and examples. It also covers task systems and coordination stages. CX Codex +1 ★ 1,357repo stars electron-pro A Claude subagent that runs an Electron project written in TypeScript: main and renderer processes, IPC through a preload bridge, packaging with electron-builder. CX Codex ★ 1,357repo stars skill-elicitation-agent skill-elicitation-agent interviews you about the skill you have in mind, then hands back a full Claude skill spec: examples, triggers, file layout and test cases. CX Codex ★ 1,357repo stars postgresql-pglite-pro The postgresql-pglite-pro subagent for Claude Code models PostgreSQL schemas, tunes SQL with EXPLAIN, and configures browser-based Pglite with IndexedDB persistence. CX Codex ★ 1,357repo stars svelte-development svelte-development — a coding agent for Svelte 5+ and SvelteKit that can help shape components, routes, server-side data loading, and form handling. CX Codex ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open