gh-issue-sync

🥈Silver

Sync GitHub issues to local Markdown files for offline editing, batch updates, and integration with coding workflows. Benefits developers and operations teams by enabling offline work and streamlining issue management.

12290Updated Today

Intermediate30min to implementautomation

Quick InstallView Source

git clone https://github.com/mitsuhiko/gh-issue-sync.git

Works with:

Claude

Overview

About This Skill

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/mitsuhiko/gh-issue-sync

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

I'm working on a project for [COMPANY] in the [INDUSTRY] sector. I need to sync GitHub issues locally so I can work offline. Please provide a step-by-step guide to set up gh-issue-sync for this purpose, including how to configure it for my specific repository and workflow.

Example Output

## Setting Up gh-issue-sync for [COMPANY]'s Repository

To set up gh-issue-sync for your project, follow these steps:

1. **Installation**: First, install the gh-issue-sync tool by running the following command in your terminal:
   ```bash
   npm install -g gh-issue-sync
   ```

2. **Configuration**: Next, configure the tool for your repository. Navigate to your project directory and create a `.gh-issue-sync` configuration file with the following content:
   ```json
   {
     "repository": "[COMPANY]/[REPOSITORY_NAME]",
     "localPath": "./issues",
     "syncInterval": "daily"
   }
   ```

3. **Syncing Issues**: To sync issues locally, run the following command:
   ```bash
   gh-issue-sync sync
   ```

4. **Working Offline**: Now you can work on the issues offline. Any changes you make will be synced back to GitHub when you run the sync command again.

5. **Pushing Changes**: To push your changes back to GitHub, run the following command:
   ```bash
   gh-issue-sync push
   ```

By following these steps, you can effectively manage GitHub issues locally and work offline without any issues.