issync
v0.2.1
Published
bidirectional github issue syncing
Maintainers
Readme
issync
Bidirectional GitHub issue syncing tool.
Features
- Bidirectional sync between GitHub and local markdown files
- Conflict detection
- Metadata support (labels, assignees, milestones, state)
- GitHub Projects v2 support (custom fields)
- Issues stored as markdown with YAML frontmatter
- Direct GitHub API integration (fast and reliable)
Requirements
- Node.js >= 18
- GitHub authentication (see below)
Installation
npm install -g issyncOr run directly:
npx issyncAuthentication
Two options:
- Environment variable: Set
GITHUB_TOKENorGH_TOKEN(get token from https://github.com/settings/tokens) - GitHub CLI: Run
gh auth login(issync usesgh auth tokenautomatically)
Usage
issync down # Sync from GitHub
issync down --closed --projects # Include closed issues and project fields
issync up # Sync to GitHub
issync up --dry-run # Preview changes
issync sync # Bidirectional sync
issync conflicts # Detect conflictsFlags: --closed --full --projects --force --dry-run
How it Works
Issues stored in .issync/issues/ as markdown with YAML frontmatter. Sync state tracked in .issync/state.json. Conflicts detected when both local and remote changed since last sync.
Licence
MIT
