SpecSync

specsync is a command-line tool that syncs your OpenSpec change set with GitHub issues.

Write a spec, run specsync, and the issue appears. Update the spec, run specsync again, and the issue updates without creating duplicates. It also works the other direction: specsync pull -issue 42 scaffolds a local OpenSpec change from an existing GitHub issue.

Two representations of the same work. One source of truth.

Install

npm i -g @androidand/specsync

or

go install github.com/androidand/specsync/cmd/specsync@latest

Prebuilt binaries are available on the GitHub Releases page.

Quick start

specsync -dry-run    # preview what would be created or updated
specsync             # sync specs → issues
specsync pull -issue 42  # pull an existing issue into a local spec

This repo dogfoods it

Every issue in the specsync GitHub repo was generated from a spec in openspec/changes/ by specsync itself. The backlog you see in GitHub is the spec set. That workflow is also a copy-pasteable reference for keeping your own repo’s specs and issues in sync.

Links

• GitHub — source, issues, releases
• npm — @androidand/specsync
• Full project page — complete command reference, use cases, and workflow examples