Skip to main content
command CX Codex

bidirectional-sync · qdhenry — Claude Code command: sync GitHub and Linear

bidirectional-sync — a slash command that pairs GitHub issues with Linear tasks and copies edits both ways, settling the ones that landed on both sides.

no license ★ 1,357 updated 2026-03-01

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

What bidirectional-sync does

Point this command at a repo and a Linear team, and Claude starts matching GitHub issues to Linear tasks in both directions. It needs the GitHub CLI and Linear MCP already set up, otherwise there is nothing to talk to. Each pair gets a record with both ids, the last edit time on each side and a hash, so the next run knows what moved.

Edits to the same item are caught by comparing timestamps. The default takes the newer one; GITHUB_WINS, LINEAR_WINS, MANUAL_MERGE and FIELD_LEVEL_MERGE are the alternatives. Under field-level merge, priority follows Linear, labels are unioned, comments are appended. A [sync-bot] marker plus a 30-second pause after each run keeps the two sides from echoing updates back and forth.

Per-label rules live in .github/linear-sync.yml — bug reports can be pushed to priority 1, drafts skipped. Run with --dry-run first to see the change list before anything is written.

What it helps with

  • match GitHub issues to Linear tasks and spot the gaps
  • settle an item that was edited on both sides
  • push bug reports to priority 1 with a label rule
  • preview a sync with --dry-run before writing anything
  • stop sync runs from bouncing updates back and forth

Example prompts for the agent

  • /bidirectional-sync run a full sync between GitHub Issues and Linear.
  • /bidirectional-sync settle conflicts with the LINEAR_WINS strategy.
  • /bidirectional-sync do a dry run and show me the change list.

How to install bidirectional-sync

Manually: put the files in place

.claude/commands/bidirectional-sync.md

Call it with /bidirectional-sync. For all projects use ~/.claude/commands/

Questions about bidirectional-sync

How do I install bidirectional-sync in Claude Code?

Put the command file at .claude/commands/bidirectional-sync.md.

What does bidirectional-sync do?

It keeps GitHub issues and Linear tasks matched and copies edits both ways, resolving conflicts as it goes.

Which conflict strategy does it use by default?

NEWER_WINS: the most recent edit on either side takes over. You can switch to GITHUB_WINS, LINEAR_WINS, MANUAL_MERGE or FIELD_LEVEL_MERGE.

Similar slash commands

All slash commands for Git and GitHub →

bidirectional-sync by other authors comes first.

bidirectional-sync davila7 bidirectional-sync sets up two-way synchronization between GitHub Issues and Linear tasks. Handles update conflicts and tracks state in local JSON files. CX Codex +1 133installs gh-issue-sync mitsuhiko gh-issue-sync — a skill for Claude Code, Codex, Cursor and other platforms that maps GitHub Issues to local Markdown files. The agent pulls, edits and pushes issues from inside the repo without touching the browser. CX Codex +1 28,500installs 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 sync-issues-to-linear davila7 sync-issues-to-linear is a Claude Code command that transfers GitHub issues to Linear, mapping fields and assignees; filters select which tasks to sync. CX Codex +1 128installs sync-automation-setup BuildWithClaude Community sync-automation-setup configures automated two-way synchronization between GitHub and Linear. Sets up webhooks, background queues, and GitHub Actions workflows. CX Codex +1 ★ 3,785repo stars sync iurykrieger sync is a Claude Code skill that re-reads vault entity sources, compares them with stored content and passes changes on for writing when notes have drifted from Confluence, GDocs or GitHub. CX Codex +1 ★ 111repo stars issue-triage BuildWithClaude Community issue-triage reads incoming GitHub issues, sets category, priority and owning team, checks for duplicates, then files a Linear task. CX Codex +1 ★ 3,785repo stars

From the same set112

The whole set →
project-health-check project-health-check is a Claude Code command that reviews Git activity, dependencies, security findings, and Linear task metrics in a project health report. It helps identify risks to investigate. CX Codex +1 ★ 1,357repo stars setup-agent-tail setup-agent-tail is a Claude Code skill that deploys agent-tail in a project, detects its framework, installs the CLI and plugins, and routes server and browser logs to files for an agent. CX Codex +1 ★ 1,357repo stars todo-branch todo-branch executes backlog items on your active Git branch through guided phases, step-by-step approvals, and a single final commit. CX Codex +1 ★ 1,357repo stars graphql-architect The graphql-architect subagent designs and improves GraphQL APIs, covering schemas, resolvers, federation, and subscriptions. Use it for new APIs, performance audits, or refactoring. CX Codex ★ 1,357repo stars dx-optimizer dx-optimizer configures developer environments, project automation scripts, and Git hooks to eliminate workflow friction and speed up onboarding. CX Codex ★ 1,357repo stars clean-branches clean-branches — a command that systematically removes merged and inactive branches from Git. Keeps your repository clean by deleting obsolete branches and syncing local state with the remote. CX Codex +1 ★ 1,357repo stars performance-engineer performance-engineer is a Claude Code subagent for finding performance bottlenecks and planning optimization work. It joins tasks involving scalability, profiling, or load testing. CX Codex ★ 1,357repo stars semantic-architect semantic-architect is a Claude Code subagent that organizes dialogue context into tree structures and preserves persistent memory across sessions. CX Codex ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open