gh-issue-sync - Setup Guide¶

Source: mitsuhiko/gh-issue-sync GitHub: mitsuhiko/gh-issue-sync (160⭐, Apache-2.0, by Armin Ronacher) Skills: 1 skill (gh-issue-sync), 2.5K installs Category: Developer Tools / GitHub First Seen: August 24, 2026 sweep (skills.sh first-listed Jan 22, 2026) Quality Tier: 🟢 Production - authored by mitsuhiko (Flask, Jinja2), live since January 2026, 2.5K installs; Gen Agent Trust Hub Pass, Socket Pass, Snyk Warn

gh-issue-sync syncs GitHub issues to local Markdown files under .issues/open/ and .issues/closed/, so an agent (or a human) can triage, search, edit, and create issues without leaving the editor or terminal. Changes are diffable, greppable, and reviewable like code - then pushed back to GitHub with a single command. For a repo like corpusiq-docs with open community epics (issues #18, #12, #7), this turns issue backlog management into a plain file workflow the agent can script.

Installation¶

The maintained-checkout pattern (recommended - keeps the skill updateable with git pull):

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

# ~/.hermes/config.yaml
skills:
  external_dirs:
    - /absolute/path/to/gh-issue-sync

Or via the skills.sh marketplace:

npx skills add mitsuhiko/gh-issue-sync

Commands¶

gh-issue-sync init            # Initialize in a git repo
gh-issue-sync pull            # Fetch open issues (--all for closed too)
gh-issue-sync push            # Push local changes (--dry-run to preview)
gh-issue-sync list            # List issues (supports gh issue list flags + --search)
gh-issue-sync new "Title"     # Create issue (--label, --edit)
gh-issue-sync close 42        # Close (--reason completed|not_planned)
gh-issue-sync reopen 42
gh-issue-sync status          # Show local changes
gh-issue-sync diff 42         # Show diff (--remote to re-fetch)

Prerequisites¶

Requirement	Details
gh CLI	The tool builds on the GitHub CLI; authenticated `gh` is expected
A git repo	Run `gh-issue-sync init` inside the repo you want issue sync for

Core Skill¶

Skill	Installs	Use For
gh-issue-sync	2.5K	Manage GitHub issues locally as Markdown files - triaging, searching, editing, and creating issues without leaving your editor or terminal

Security Audit Status (skills.sh, verified Aug 24, 2026)¶

Skill	Gen Agent Trust Hub	Socket	Snyk
gh-issue-sync	Pass	Pass	Warn

CorpusIQ Use Cases¶

Use Case	How
Issue backlog as files	Sync corpusiq-docs issues (community epics #18, #12, #7 and the open PR queue) to `.issues/` - triage and label in bulk with grep/scripting instead of the web UI
Reviewable issue edits	`push --dry-run` + `diff` give a code-review-style path for bulk issue updates - matches the agent's verify-before-assertion discipline
Agent-scripted triage	The plain Markdown format makes automated triage cron jobs (stale-issue sweeps, label normalization) simple shell scripts

Integration with CorpusIQ¶

CorpusIQ is the connector layer that lets AI assistants read the systems a business already runs on - accounting, payments, CRM, email, files and analytics - and answer with the source named. It is read-only by design: it retrieves data and never writes to, or acts in, a connected system, which is what makes it safe to point at live accounts.

This page is part of the CorpusIQ directory, the reference we maintain for the MCP server and agent-skill ecosystem. Run alongside CorpusIQ, a third-party server like this one can be combined with a company's own business data in a single answer.

See what CorpusIQ connects

Limitations / Verification¶

Snyk audit is Warn-level on skills.sh - review dependencies before production use, though the tool's surface is a thin CLI over gh.
Requires the gh CLI and its auth; not a replacement for the GitHub API in agent workflows, a complement for human/file-based workflows.
Single-purpose tool - issue sync only, no PR or project-board surface.

GitHub Code Review Setup - review workflow skills
Skills Marketplace - more discovery batches