paperclip-plugin-linear

Paperclip plugin for bidirectional Linear issue sync. Built by Lucitra for use with our Paperclip fork.

Note: This plugin provides agent-side tools (search, create, link). The server-side Linear integration (OAuth, import, webhooks, project sync) lives in the Paperclip fork at server/src/routes/linear-auth.ts. Both work together — the plugin handles per-issue linking while the server handles org-wide sync.

Related

• lucitra/paperclip — Paperclip fork with Linear OAuth, import, webhook sync
• lucitra/paperclip-plugin-chat — Chat interface plugin
• @lucitra/paperclip-plugin-linear on npm

Features

• Link issues — Connect Paperclip issues to Linear issues for bidirectional sync
• Status sync — Status changes propagate both directions (configurable: bidirectional, linear-to-paperclip, or paperclip-to-linear)
• Comment bridging — Comments sync between linked issues (opt-in)
• Agent tools — Agents can search, create, link, and unlink Linear issues
• Webhook support — Real-time updates from Linear via webhooks
• Issue detail tab — See linked Linear issue info directly in Paperclip UI

Installation

# In your Paperclip instance
npx paperclipai plugin install paperclip-plugin-linear

Configuration

In Paperclip Settings → Plugins → Linear Issue Sync:

1. Create a secret with your Linear API key (Settings → Secrets)
2. Set linearTokenRef to the secret's UUID
3. Set teamId to your Linear team ID
4. Optionally enable comment sync and choose sync direction

Agent Tools

| Tool | Description | |------|-------------| | search-linear-issues | Search Linear issues by query | | create-linear-issue | Create a new issue in Linear | | link-linear-issue | Link a Linear issue to a Paperclip issue | | unlink-linear-issue | Remove the sync link |

Development

pnpm install
pnpm build      # Build TypeScript
pnpm typecheck  # Type check without emitting
pnpm dev        # Watch mode

License

MIT