Skip to main content
command CX Codex

sync-status — Claude Code command: what it does, install

The sync-status command for Claude Code checks GitHub–Linear sync health, queues, webhooks, failures, and data mismatches. It supports diagnosis of synchronization issues.

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

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

What sync-status does

The command builds a GitHub and Linear sync overview with recent full and incremental runs, synced items, queued work, failures, direction, and webhook state. It calculates sync duration, success and conflict rates, duplicate and orphaned items, API limits, lag, and records that are out of sync.

Consistency checks match GitHub issues with Linear tasks and report missing records or field differences. History analysis groups runs by type and direction, then highlights recurring errors, slow operations, and changes in volume or duration. A diagnostic report checks API connectivity, GitHub CLI, Linear MCP, webhooks, duplicates, conflicts, and orphaned records.

Webhook checks call gh api, so that part of the diagnosis cannot run without GitHub CLI. Separate modes cover detailed status, health checks, continuous monitoring, queue handling, issue checks, and diagnostic output.

What it helps with

  • check GitHub–Linear sync health
  • find records missing from either system
  • compare GitHub issue and Linear task fields
  • inspect sync errors and lag over time
  • verify webhooks and queued operations

Example prompts for the agent

  • Run sync-status and show the current GitHub–Linear sync status.
  • Run sync-status --health-check to inspect failures, lag, and API limits.
  • Generate a diagnostic report with sync-status --diagnostics.

How to install sync-status

Manually: put the files in place

.claude/commands/sync-status.md

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

Questions about sync-status

How do I install sync-status in Claude Code?

Place the command file at .claude/commands/sync-status.md, then run sync-status in Claude Code.

What does sync-status do?

It monitors GitHub–Linear synchronization, reports queue and failure status, measures health signals, checks webhooks, and finds data mismatches. It can also produce a diagnostic report.

What does sync-status need for webhook checks?

Webhook checks use gh api, so GitHub CLI must be available for that part of the command.

Similar slash commands

All slash commands for Git and GitHub →

From the same set112

The whole set →
ci-setup ci-setup — a Claude slash command that builds out a CI/CD pipeline: it reads your stack, picks a platform and writes the config for tests, Docker and deploys. CX Codex +1 ★ 1,357repo stars prepare-release The prepare-release command walks through release preparation, from checks and version updates to build validation and Git tagging. Use it when a release needs a defined checklist. CX Codex +1 ★ 1,357repo stars hotfix-deploy hotfix-deploy is a Claude Code command that guides critical fixes through incident triage, testing, release monitoring, and rollback. CX Codex +1 ★ 1,357repo stars performance-auditor performance-auditor — a subagent that hunts bottlenecks: algorithm cost, N+1 queries, bundle size, wasted re-renders. You get a prioritized report. CX Codex ★ 1,357repo stars sync-linear-to-issues sync-linear-to-issues exports Linear tasks into GitHub issues while preserving issue descriptions, sprint milestones, and status mappings. CX Codex +1 ★ 1,357repo stars task-from-pr task-from-pr is a Claude Code command that transfers GitHub pull request details to a Linear task, linking PR work with project tasks. CX Codex +1 ★ 1,357repo stars memory-merge The memory-merge command consolidates multiple semantic tree nodes into one, removing duplicates and grouping related concepts under a single node. CX Codex +1 ★ 1,357repo stars sync-conflict-resolver The sync-conflict-resolver command for Claude Code identifies and resolves data conflicts between GitHub issues and Linear tasks, merging non-conflicting fields or applying a chosen strategy. CX Codex +1 ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open