Linear in Roma

Turn what you spotted into an issue in the right team, from any device.

Connect Linear and your operator files issues for you, in the right team, from what you say. "Create a bug in iOS: login broken on 5G" becomes an issue with that title in the iOS team, in one round trip, with no questions asked. The operator also reads and searches issues, updates them, comments on them and archives them when you ask.

What the operator does in Linear

Sam is on the train when he spots the bug. He tells Roma "Create a bug in iOS: login broken on 5G, assign it to me", and the issue appears in Linear a moment later, assigned to him, with its link in the conversation. The operator read the team off his words (iOS matches a team called iOS or Mobile iOS), set the title from his phrasing and put the detail in the description. It never asks which team.

"File a Linear issue for the onboarding regression" names no team, so the issue goes to the default team on the connection's page. With no default set, the first team on the account takes it.

With an issue in hand: "Comment on ENG-123: fixed in main, deploying" adds the comment, asking first, since a comment reaches other people. "Update ENG-123 to In review" updates the issue, "take the label off" removes a label, and "archive it" archives it, asking first, because archiving is Linear's delete. "Show my Linear backlog" and "find the issue about the login" search. The operator can also read a Linear project, the teams, labels, states, cycles and members.

A screenshot attached in the composer goes into the issue's description, hosted by Linear. That works from the browser and the Mac app. The issue's link opens the Linear app when it is installed, and Linear on the web otherwise.

The default team

Connecting Linear sets your default team to the first team on your account. The connection's page in Settings has Default team for new issues, used when a chat-driven issue does not name a team: pick another team, or No default. The picker is on the Mac and in the browser. "Assign it to me" needs no setting at all: Roma learned who you are in Linear when you connected.

What asks first, and what it never does

Reading, creating and updating run when you ask. A comment and an archive ask first, with a card naming the issue, unless you set Sending or Deleting to Always allow on the connection's page. The card is the one described in Approvals. The operator never deletes an issue outright, never creates Linear projects, labels or milestones, and never fills in a field you did not name: no invented label, state or assignee. Linear is not where your tasks live. Roma keeps your tasks on your lists, and an issue is a separate thing you file by asking.

How to connect

Open Settings → Connections and press Linear. Sign in with Linear in the window that opens, allow the access it lists, and close the page when it says Connected. The row carries a green check, and its page shows the default team and the permissions. The iPhone's Settings → Connections carries the same row, so filing from the phone works. The default team is set on the Mac or in the browser. The general steps are in Connect an app to Roma, and the public page is /connections/linear.

How to disconnect

Settings → Connections, press Linear, then Disconnect. Roma loses its access at once, and the default team and what it knew of your workspace go with it. Issues you filed stay in Linear.

Questions people ask

Which team does an issue go to?

The team you name, loosely matched, so iOS finds a team called iOS or Mobile iOS. With no team in your words, the default team on the connection's page, which Roma set to your first team when you connected. With no default, the first team on your account. The operator never asks you to choose.

Can the operator assign an issue to someone else?

Yes, when you name them: "assign it to Noor" finds Noor among the workspace's members. "Assign it to me" is resolved from your own Linear account, with no lookup.

Can it see my whole backlog?

It searches by words, reads one issue by its key, and lists a team's issues or the issues assigned to someone. Ask for the issues you mean rather than everything at once.

Does a comment ask first?

Yes. A comment reaches other people under your name, so it shows a card and waits for you, unless you set Sending to Always allow for Linear.