Linear

Ellipsis answers mentions on Linear issues, works issues delegated to it, and gives sessions Linear tools.

Answer a mention

1. Connect a workspace from Integrations > Linear in the dashboard.
2. Mention Ellipsis with a question in a comment on an issue.

Delegate an issue

Set Ellipsis as the delegate on an issue to start a session on it. The session reads the issue and its comments, and replies in the issue's agent session. Other agents can delegate too, through the Linear API. If Ellipsis isn't offered as a delegate, reconnect Linear from Integrations > Linear.

Agent access

A session gets Linear tools when its environment lists linear under mcp_servers, or when it starts from Linear. A session that lists linear while Linear isn't connected fails at start.

Mention routing

Mention Ellipsis in a comment on a Linear issue, picking it from the mention list, to start a session. Ellipsis answers in that comment's thread, and replies in the thread continue the same session. A typed @ellipsis starts nothing. If Ellipsis isn't in the mention list, reconnect Linear from Integrations > Linear. Delegations route the same way as mentions. Without a linear.yaml, the built-in handler answers. To customize it, put linear.yaml at the root of your organization's .ellipsis repository:

This handler answers mentions on issues in the ENG team or the Website project. Other issues use the built-in handler.

Set at least one of linear.teams or linear.projects. Don't mix '*' with team names. Names match regardless of case.

Linear issues aren't tied to a repository, so list the repositories the handler needs in session.environment, or name a saved environment that has them.

The default-branch version is live, and an invalid edit keeps the last valid one. Set ellipsis.enabled: false, or delete the file, to go back to the built-in handler. Only the copy in the .ellipsis repository counts.

Issue events

To run an agent whenever someone creates an issue, use a linear_issue trigger.

Fields