@bettsnation/paperclip-plugin-github

Paperclip plugin for bidirectional GitHub Issues sync.

Inbound (GitHub → Paperclip)

• GitHub issue created/labeled with trigger label → plugin creates Paperclip issue
• Verifies X-Hub-Signature-256 natively (no signing incompatibility)
• Routes to configured agent (Lead Engineer or Full Stack Developer)

Outbound (Paperclip → GitHub)

• Paperclip issue completed → closes linked GitHub issue with comment

Install

npm install @bettsnation/paperclip-plugin-github

Or: Instance Settings → Plugins → Install Plugin → @bettsnation/paperclip-plugin-github

Configuration

| Setting | Required | Description | |---------|----------|-------------| | githubTokenRef | Yes | Secret ref for GitHub API token | | webhookSecretRef | Yes | Secret ref for webhook signature verification | | targetCompanyId | Yes | Paperclip company for new issues | | defaultAgentId | Yes | Agent to assign new issues to | | triggerLabel | No | Only sync issues with this label (default: paperclip) | | syncClosedBack | No | Close GitHub issues on completion (default: true) |

GitHub Webhook Setup

In each repo (or org-level): Settings → Webhooks → Add webhook

• Payload URL: Plugin webhook endpoint from Paperclip
• Content type: application/json
• Secret: Same secret stored in Paperclip secret ref
• Events: Select "Issues"

Label-Based Routing

Only GitHub issues with the configured triggerLabel (default: paperclip) are synced. This prevents every GitHub issue from flooding Paperclip — only explicitly tagged issues get picked up.

License

MIT