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
.claude/commands/sync-status.mdWhat 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-statusand show the current GitHub–Linear sync status. - Run
sync-status --health-checkto 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.mdCall it with /sync-status. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/sync-status.mdCall it with /prompts:sync-status. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/sync-status.prompt.mdManually: put the files in place
.gemini/commands/sync-status.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
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.