Skills
.Work. You
Rest

Setup tips & tricks — Linear × CMA webhook bridge

Community

Reply to Linear issues with CMA-generated comments

Software Engineering#oauth#claude#linear#diff review#managed agents#webhook bridge#session routing
AuthorObservatoriodomos
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Guides setup and debugging for a bridge that turns a user’s Linear @mention into a Claude Managed Agent (CMA) run, then posts the resulting CMA reply back into Linear as a comment.

Core Features & Use Cases

  • Webhook bridge mental model: Explains the “doorbell” nature of webhooks and why the bridge must translate IDs and routing metadata across Linear and CMA.
  • Routing via session metadata: Uses CMA session metadata (linear session id and org id) so the idle webhook can reliably find where to post the response in Linear.
  • Production-grade gotchas: Covers workspace scoping, required webhook event types, actor=app OAuth behavior, the 10-second ack requirement, and idempotency with event.id, plus debugging steps for silent failures.

Quick Start

Ask your agent to “walk me through setting this up” so it can follow the Linear OAuth app creation, Anthropic agent/webhook configuration, required environment variables, and then run the local bridge server to enable @mentions.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: Setup tips & tricks — Linear × CMA webhook bridge
Download link: https://github.com/Observatoriodomos/DomosMirador/archive/main.zip#setup-tips-tricks-linear-cma-webhook-bridge

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.