command

issue-to-linear-task — Claude Code command: what it does

Q: How to install issue-to-linear-task in Claude Code?

Run `npx claude-code-templates@latest --command sync/issue-to-linear-task` in your project terminal. This places the command file at `.claude/commands/issue-to-linear-task.md`.

Q: How does it map GitHub users to Linear accounts?

Put a `@user-mappings.json` file in your repository with username matches. The command reads it during transformation to assign the right teammates in Linear.

Converts individual GitHub issues into Linear tasks while keeping comments, formatting, and issue links intact. Useful when migrating bug trackers or syncing items.

Install into Claude Code · claude-code-templates All methods and platforms ↓

npx claude-code-templates@latest --command sync/issue-to-linear-task

Open on GitHub

What issue-to-linear-task does

The command inspects a single GitHub issue and creates a corresponding item inside Linear. It maps metadata, extracts priority, and retains descriptions. Comments are imported with their author attribution, attachments remain linked, and cross-references connect both systems bidirectionally.

Execution relies on Read, Write, Edit, and Bash tools. Claude Code queries gh repo view to identify the active repository. For assigning teammates, it consults @user-mappings.json. Conversion parameters accept flags like --team, --project, --close-github, and --skip-comments.

Repository detection fails without an active gh CLI session.

What it helps with

export a GitHub issue into a Linear project
keep threaded comments and attachments during ticket migration
build bidirectional links between GitHub and Linear items
close the original GitHub issue automatically after importing

Example prompts for the agent

/issue-to-linear-task 42 --team ENG --close-github
/issue-to-linear-task 105 --project "Q3 Roadmap" --skip-comments
/issue-to-linear-task 12

How to install issue-to-linear-task

1claude-code-templates

npx claude-code-templates@latest --command sync/issue-to-linear-task

2Manually: 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/

Manually: put the files in place

~/.codex/prompts/issue-to-linear-task.md

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

Manually: put the files in place

.gemini/commands/issue-to-linear-task.toml

Gemini 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?

Run npx claude-code-templates@latest --command sync/issue-to-linear-task in your project terminal. This places the command file at .claude/commands/issue-to-linear-task.md.

What does issue-to-linear-task do?

It converts a chosen GitHub issue into a Linear task. The command preserves formatting, links comments to original authors, and adds cross-references between platforms.

How does it map GitHub users to Linear accounts?

Put a @user-mappings.json file in your repository with username matches. The command reads it during transformation to assign the right teammates in Linear.

Source text

issue-to-linear-task.md · MIT

---
allowed-tools: Read, Write, Edit, Bash
argument-hint: "[issue-number] | --team | --project | --close-github | --skip-comments"
description: Convert individual GitHub issues to Linear tasks with comprehensive data preservation
---

# Issue to Linear Task

Convert GitHub issues to Linear tasks with comprehensive field mapping: **$ARGUMENTS**

## Current Conversion Context

- Repository: !`gh repo view --json nameWithOwner -q .nameWithOwner 2>/dev/null || echo "No repo context"`
- Issue details: Based on $ARGUMENTS issue number or selection criteria
- Linear teams: Available Linear teams and project assignments
- User mappings: @user-mappings.json or GitHub-Linear user correspondence

## Task

Execute precise conversion of individual GitHub issues to Linear tasks:

**Issue Target**: Use $ARGUMENTS to specify issue number, conversion options, team assignment, or processing preferences

**Conversion Framework**:
1. **Issue Analysis** - Fetch complete issue data, extract metadata, analyze content structure, infer priorities
2. **Data Transformation** - Map fields accurately, convert formats, preserve relationships, enhance descriptions
3. **Linear Integration** - Create task with proper formatting, assign team/project, set priorities, manage labels
4. **Content Migration** - Import comments with attribution, handle attachments, preserve formatting, maintain threading
5. **Reference Management** - Create bidirectional links, update sync database, maintain cross-references, enable navigation
6. **Validation & Confirmation** - Verify conversion accuracy, confirm field mappings, validate relationships, provide preview

**Advanced Features**: Smart priority inference, intelligent user mapping, attachment handling, comment threading, comprehensive validation.

**Data Fidelity**: Preserve original formatting, maintain all metadata, keep comment attribution, ensure relationship integrity.

**Output**: Successfully converted Linear task with complete data preservation, accurate field mappings, bidirectional references, and comprehensive conversion summary.

Similar slash commands

All slash commands for Git and GitHub →

code-review official Anthropic Runs a multi-agent code review on a pull request using the gh CLI. It checks CLAUDE.md guidelines and weeds out false positives. 5,537installs commit official Anthropic Creates a git commit based on current branch changes. Helps stage and commit diffs in Claude Code without typing commit messages. 4,121installs review-pr official Anthropic This command uses specialized agents to review PR changes, covering tests, error handling, types, comments, and general code quality. ★ 44,770repo stars maker-setup official Anthropic This command prepares a Code-with-Claude Cardputer-Adv by fetching the build repository, flashing firmware, and installing the Claude Buddy apps. ★ 44,770repo stars commit-push-pr official Anthropic Creates a feature branch if needed, commits staged and unstaged edits, pushes to origin, and opens a pull request via GitHub CLI. ★ 44,770repo stars clean_gone official Anthropic Finds local Git branches marked [gone], removes their associated worktrees, then deletes the branches. Use it to clear local branches whose remote copies are gone. ★ 44,770repo stars

From the same set740

The whole set →

telegram-mini-app Plan Telegram Mini Apps with guidance on the Web App API, TON Connect, payments, and Telegram user data. Useful when building a web app that runs inside Telegram. 128installs sync-issues-to-linear Move GitHub issues into Linear with field and assignee mapping. Filter the set by state, labels, milestone, assignee, or specific issues. 128installs nuget-manager Manages NuGet dependencies across .NET solutions using dotnet CLI. It enforces clean addition, removal, and verified version bumps. 128installs react-useeffect A skill that walks through React's useEffect rules from the official docs and points out what to use instead when an Effect is unnecessary. 127installs svelte-scaffold Builds out a new SvelteKit project, feature module or component library with a ready folder layout and config files. Handy when you want a starting point without wiring it by hand. 127installs pymoo Use this skill to work through Python optimization problems, from a single objective to competing goals. It helps when you need to compare trade-offs or account for constraints. 125installs notion-template-business Turns Claude Code into an advisor for building and selling Notion workspaces, covering tier pricing, asset packaging, and checkout platform setups. 124installs vercel-deployment A Claude skill that tells your agent how to deploy Next.js to Vercel: env vars per environment, edge vs serverless, build cache. 124installs