command

sync-pr-to-task — Claude Code command for linking PRs to Linear

Q: How do I install sync-pr-to-task in Claude Code?

Run `npx claude-code-templates@latest --command sync/sync-pr-to-task`.

Connects GitHub pull requests with Linear tasks and syncs task state. Use it to keep PR details and task updates together.

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

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

Open on GitHub

What sync-pr-to-task does

The command checks a pull request for Linear task IDs in its title, description, branch name, and commit messages. It can use PR state and review details to update a task, add a PR reference or comment, and put task context on GitHub.

Pass a PR number or an option such as --task, --auto-detect, --enable-auto, or --update-state to choose the action. It gets repository context with gh repo view, so automatic PR detection may fail when that context is unavailable.

What it helps with

find a Linear task referenced by a pull request
map PR state to a task status
attach PR links and comments to a Linear task
turn on synchronization between GitHub and Linear

Example prompts for the agent

Link pull request 42 to its Linear task: /sync-pr-to-task 42.
Find the Linear task for the current pull request: /sync-pr-to-task --auto-detect.
Update the task state from the pull request: /sync-pr-to-task --update-state.

How to install sync-pr-to-task

1claude-code-templates

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

2Manually: put the files in place

.claude/commands/sync-pr-to-task.md

Call it with /sync-pr-to-task. For all projects use ~/.claude/commands/

Manually: put the files in place

~/.codex/prompts/sync-pr-to-task.md

Call it with /prompts:sync-pr-to-task. Codex marks this format deprecated in favour of skills

Manually: put the files in place

.github/prompts/sync-pr-to-task.prompt.md

Manually: put the files in place

.gemini/commands/sync-pr-to-task.toml

Gemini stores commands as TOML: the prompt text goes into the prompt field

Questions about sync-pr-to-task

How do I install sync-pr-to-task in Claude Code?

Run npx claude-code-templates@latest --command sync/sync-pr-to-task.

What does sync-pr-to-task do?

It links GitHub pull requests to Linear tasks, detects task IDs, and coordinates task details with PR state and review information.

Where does sync-pr-to-task look for Linear task IDs?

It checks the PR title and description, branch name, and commit messages.

Source text

sync-pr-to-task.md · MIT

---
allowed-tools: Read, Write, Edit, Bash
argument-hint: "[pr-number] | --task | --auto-detect | --enable-auto | --update-state"
description: Link GitHub pull requests to Linear tasks with automated state synchronization and workflow integration
---

# Sync PR to Task

Link GitHub pull requests to Linear tasks with comprehensive workflow integration: **$ARGUMENTS**

## Current PR Context

- Repository: !`gh repo view --json nameWithOwner -q .nameWithOwner 2>/dev/null || echo "No repo context"`
- PR details: Based on $ARGUMENTS PR number or auto-detection criteria
- Linear references: Detection of task IDs in PR content and branch names
- Webhook status: Current automation configuration for PR-task synchronization

## Task

Implement comprehensive pull request to Linear task linking with automated workflow integration:

**PR Target**: Use $ARGUMENTS to specify PR number, task assignment, auto-detection mode, or automation configuration

**Integration Framework**:
1. **Reference Detection** - Extract Linear task IDs from PR title, body, branch names, commit messages
2. **PR Analysis** - Fetch complete PR data, analyze state, review status, change metrics, timeline
3. **State Synchronization** - Map PR states to Linear equivalents, handle review cycles, merge events
4. **Task Updates** - Update Linear task status, add PR references, create comments, sync metadata
5. **GitHub Enhancement** - Add Linear context to PR, create labels, post task summaries, maintain links
6. **Workflow Automation** - Configure webhooks, enable real-time sync, implement event handlers, maintain consistency

**Advanced Features**: Smart branch detection, automated state mapping, review integration, commit analysis, comprehensive validation.

**Workflow Integration**: Real-time updates, bidirectional sync, event-driven automation, comprehensive monitoring.

**Output**: Complete PR-task integration with automated synchronization, workflow enhancement, state management, and comprehensive relationship tracking.

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 set804

The whole set →

data-processing-nemo-curator Instructs Claude Code on creating data preparation pipelines for neural network training using NVIDIA NeMo Curator on GPUs. 123installs sync-linear-to-issues Transfers Linear tasks to GitHub issues with state mapping, attachment migration, and comment sync. Useful when consolidating project tracking into GitHub. 123installs idor-testing A testing skill for discovering IDOR flaws and broken access controls in web apps. Useful for checking whether users can reach unauthorized records or files. 122installs distributed-training-pytorch-lightning Refactors standard PyTorch loops into LightningModule structures and manages multi-GPU execution using DDP, FSDP, or DeepSpeed. 122installs api-security-testing A skill that walks the agent through seven phases of API security work, from endpoint discovery to error handling. Useful when you need to probe an API for holes. 121installs github-workflow-automation A skill with ready-made patterns for AI-driven PR reviews, issue triage and CI/CD on GitHub. Useful when you are wiring automation into a repository. 121installs sync-health-monitor A slash command that checks GitHub-Linear sync health: API limits, webhooks, latency, error patterns. Useful when issues stop reaching the other side. 121installs svelte-storybook-mock Sets up SvelteKit module mocks in Storybook stories so a component renders in isolation, without the app running. 121installs