gh-issue-sync

gh-issue-sync is a command-line tool that mirrors GitHub issues into local Markdown files with YAML front matter, enabling offline editing and batch updates. The tool supports creating new issues locally with temporary IDs that get replaced with real issue numbers after pushing to GitHub. It uses three-way comparison to detect conflicts between local, original, and remote versions, automatically handling references and creating missing labels or milestones during sync. Developers and coding agents can pull issues, refine them locally in their preferred editor, and push changes back in a single operation. The tool integrates with popular AI agents including Claude Code, Cursor, and others through customizable skill files.

["Install GitHub CLI (gh) and authenticate with 'gh auth login'","Run the sync command with your repository and directory parameters","Review the summary report to verify changes","Edit the Markdown files offline as needed","Push changes back to GitHub using 'gh issue create' or manual PRs","Tip: Use 'gh issue list --label [LABEL]' to preview issues before syncing"]