# sync-status

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

- 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-status.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-status

## What it 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.

## Install

### Claude Code (native platform)

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

### Codex

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

### GitHub Copilot

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

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/sync-status.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-status.md

## When to use it
- 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
- 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`.

## Similar
- [sync-automation-setup](https://affpapa.org/en/nevibecode/commands/sync-automation-setup.md) — command · 181 installs
- [sync-health-monitor](https://affpapa.org/en/nevibecode/commands/sync-health-monitor.md) — command · 121 installs
- [sync-coordinator](https://affpapa.org/en/nevibecode/commands/sync-coordinator.md) — command · ★ 850 repo stars
- [gh-issue-sync](https://affpapa.org/en/nevibecode/skills/gh-issue-sync.md) — skill · 28500 installs
- [status-report-generator](https://affpapa.org/en/nevibecode/skills/status-report-generator.md) — skill · 145 installs
- [sync](https://affpapa.org/en/nevibecode/skills/iurykrieger-sync.md) — skill · ★ 111 repo stars

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
