Paperclip GitHub Plugin

GitHub Sync — [Paperclip](https://github.com/paperclipai/paperclip) plugin for teams that plan in Paperclip but still receive work via GitHub issues. Maps repos → projects, imports open issues, keeps them current, adds a project PR queue, KPI widgets, and agent tools for issues/PRs/CI/review. npm paperclip-github-plugin (v0.16.x). Apache-2.0.

What you get

Company-scoped settings: GitHub token, repo mappings, import defaults, board access, sync cadence Import open GitHub issues as top-level Paperclip issues (no title prefixes; re-sync updates in place) Label sync by name; GitHub metadata on dedicated surfaces (not stuffed into the body) Dashboard widget (readiness, run/cancel) + KPI widget (backlog, issues closed, Paperclip-created PRs) Sync diagnostics: per-issue failures, raw errors, next steps Project sidebar Pull Requests queue: filters, review/CI actions, open-PR badge Issue GitHub tab: link/unlink GH issue or PR, creator, troubleshooting Manual sync from global, project, and issue surfaces; scheduled runs; cooperative cancel Status from linked PRs (incl. cross-repo), mergeability, CI, reviews, threads, trusted comments

Status mapping (summary)

| GitHub condition | Paperclip status | | --- | --- | | Open, no PR, maintainer-created | todo on first import | | Open, no PR | Configured default (often backlog) | | Open + PR, unfinished CI | inprogress | | Failing CI / non-mergeable / open threads | todo or inprogress + executor handoff | | Green CI, merge-ready, threads resolved | inreview | | Closed finished / notplanned|duplicate | done / cancelled |

Agent tools (highlights)

Search duplicates; read/update issues; comment; create PRs; inspect files & CI; review threads; request reviewers; org Projects; linkgithubitem for third-party repos; getissueinteractionsummary (≤30-day ledger of sync decisions and mutating tool attempts — no bodies/credentials).

Requirements

Node.js 20+ · Paperclip host with plugin install (built against 2026.626.0; capability-based) · GitHub token with API access to mapped repos.

Install