Linear

Assign Linear tickets to Opulent and turn them into PRs

Setting up the integration

1. In your Opulent account at platform.opulentia.ai, go to Settings > Connections > Linear, and click "Connect".
2. You'll be redirected to Linear to review permissions and grant Opulent access. You can select which teams in Linear Opulent will have access to. You can always change Opulent's access directly in the Linear Apps settings later.
3. Once connected, configure your synced playbook labels and optionally set up automation triggers in the settings page.

How to trigger Opulent from Linear

There are three ways to start an Opulent session from a Linear ticket:

Assign Opulent to a ticket

Assign the ticket to Opulent directly in Linear. Opulent will use the default playbook configured in your Linear integration settings to start working on the ticket.

Add a playbook label

Add a playbook label (e.g. !plan, !implement, !triage, !review) to the ticket. Opulent will start a session using the specific playbook that matches the label. These labels are synced from your configured synced playbook labels in the integration settings.

@mention Opulent in a comment

Mention Opulent in a ticket comment with specific instructions. Opulent will start a session and use your comment as the task instruction, without applying a playbook.

Configuring the integration

Synced playbook labels

Playbook labels let you control which Opulent playbooks are available directly from Linear as labels. When you add a playbook to the synced list, its macro (e.g. !plan) becomes available as a Linear label in the "Opulent Playbooks" label group.

• Default playbook: One playbook is marked as the default. When a ticket is assigned to Opulent without a specific playbook label, Opulent uses this default playbook. The !plan playbook is set as the default for new connections.
• Adding playbooks: Click "Add playbook" to sync additional playbooks. Only playbooks with a macro can be synced.
• Removing playbooks: Remove a playbook to stop syncing its label to Linear.

Automation triggers

Automation triggers let Opulent automatically start working on tickets when they match certain conditions, without manual assignment or labeling — this is the auto-triage path for Linear. You can configure triggers based on:

• Teams: Only trigger for tickets in specific Linear teams.
• Labels: Only trigger when a ticket has specific labels.
• Statuses: Only trigger when a ticket reaches a specific status (e.g. "Todo", "In Progress").
• Playbook: Optionally specify which playbook Opulent should use for the triggered session.

Triggers use edge detection, meaning they only fire when a ticket transitions from not matching to matching the trigger conditions (e.g. when a label is added or a status changes), not for tickets that already match.

Enterprise: Linear team mapping

For enterprise deployments with multiple Opulent organizations, admins can map Linear teams to specific Opulent organizations. This ensures tickets from each Linear team are routed to the correct Opulent organization. A mapping is required for the Linear integration to work in enterprise setups.

Interacting with Opulent in Linear

Once Opulent starts working on a ticket, it uses Linear's agent session interface to communicate:

• Activity feed: Opulent posts real-time updates as it works, including commands run, files edited, and progress summaries.
• Plan tracking: Opulent's todo list syncs to Linear's plan UI so you can see progress at a glance.
• Follow-up messages: Send messages in the agent session thread to give Opulent additional instructions or ask questions.
• Stop Opulent: Use the stop signal in Linear to put Opulent to sleep on the current task.
• PR links: When Opulent creates a pull request, the PR URL is automatically added to the agent session for easy access.
• Session link: A direct link to the Opulent session in the web app is added to the agent session, along with a link to the playbook used (if applicable).

Connecting your Linear user account

In addition to the organization-level integration, individual team members can link their Linear account to their Opulent account. This allows Opulent to recognize who triggered a ticket and attribute sessions to the correct user.

To connect your user account, go to Settings > Connections > Linear and link your account in the user connection section.