# sync-linear-to-issues

sync-linear-to-issues exports Linear tasks into GitHub issues while preserving issue descriptions, sprint milestones, and status mappings.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/commands/sync/sync-linear-to-issues.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/qdhenry-sync-linear-to-issues

## What it does

This command retrieves issues from Linear via MCP and writes them to GitHub using the `gh` CLI tool. It maps task titles, acceptance criteria, assignees, and projects directly to GitHub issue fields and milestones. Active states like Backlog, Todo, or In Review map to open issues, while Done or Canceled states map to closed issues.

Issue priorities turn into labels such as `priority/high` or `priority/urgent`. Each created issue gets a footer containing the Linear identifier and a direct URL. It also copies attachments, syncs comments, and handles API rate limits by sending requests in batches of 20 with a two-second delay.

The routine fails immediately if your `gh` CLI is unauthenticated or the Linear MCP server is absent.

## Requirements
- Works with: Linear

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/sync-linear-to-issues.md` — Call it with /sync-linear-to-issues. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/sync-linear-to-issues.md` — Call it with /prompts:sync-linear-to-issues. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/sync-linear-to-issues.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/sync-linear-to-issues.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/commands/sync/sync-linear-to-issues.md

## When to use it
- Export active Linear tasks into a GitHub repository
- Convert Linear priority levels into standardized GitHub labels
- Backfill comments and attachment links into GitHub issues
- Track Linear ticket identifiers directly in issue footers

## Example prompts
- Sync all tasks from Linear team ENG to this GitHub repository
- Import Linear tasks for project Sprint 23 with urgent and high priority
- Update existing GitHub issues with fresh comments from Linear

## Similar
- [sync-issues-to-linear](https://affpapa.org/en/nevibecode/commands/sync-issues-to-linear.md) — command · 128 installs
- [bidirectional-sync](https://affpapa.org/en/nevibecode/commands/bidirectional-sync.md) — command · 133 installs
- [Linear Automation](https://affpapa.org/en/nevibecode/skills/linear-automation.md) — skill · 4800 installs
- [bulk-import-issues](https://affpapa.org/en/nevibecode/commands/buildwithclaude-community-bulk-import-issues.md) — command · ★ 3785 repo stars
- [groove-utilities-task-list](https://affpapa.org/en/nevibecode/skills/groove-utilities-task-list.md) — skill · 579 installs
- [implement-task-linear](https://affpapa.org/en/nevibecode/skills/implement-task-linear.md) — skill · 346 installs

## Other versions with the same name
- [sync-linear-to-issues · davila7](https://affpapa.org/en/nevibecode/commands/sync-linear-to-issues.md) — 123 installs

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
