sync-linear-to-issues · qdhenry — Claude Code command: setup guide
sync-linear-to-issues exports Linear tasks into GitHub issues while preserving issue descriptions, sprint milestones, and status mappings.
no license ★ 1,357 updated 2026-03-01
.claude/commands/sync-linear-to-issues.mdWhat sync-linear-to-issues 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.
What it helps with
- 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 for the agent
- 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
How to install sync-linear-to-issues
Manually: put the files in place
.claude/commands/sync-linear-to-issues.mdCall it with /sync-linear-to-issues. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/sync-linear-to-issues.mdCall it with /prompts:sync-linear-to-issues. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/sync-linear-to-issues.prompt.mdManually: put the files in place
.gemini/commands/sync-linear-to-issues.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about sync-linear-to-issues
How to install sync-linear-to-issues in Claude Code?
Save the command definition file directly to .claude/commands/sync-linear-to-issues.md in your project directory.
What does sync-linear-to-issues do?
It reads tasks from Linear via an MCP server and creates matching GitHub issues with converted statuses, labels, and metadata.
What dependencies are required to run this command?
You need an active Linear MCP server connection and an authenticated gh command-line tool targeted at your repository.
Similar slash commands
All slash commands for Notes, tasks and projects →sync-linear-to-issues by other authors comes first.