Integrations
Operators + Linear: issues waiting on you, every company
Updated 2 min read By Operators team
What you will see from Linear
| On your board | From Linear |
|---|---|
| Waiting on you | Issues assigned to you in a review state |
| Due (shown when the day comes) | Issues assigned to you, by due date |
| Done today | Issues completed today in your teams |
Why connect Linear to Operators?
If you run more than one company, you probably have more than one Linear workspace, and each one has its own inbox, its own “My issues” and its own idea of what is urgent. Checking them one by one is how a review request sits for three days.
Operators reads each workspace and shows the issues that need you on one screen, with the company’s colour and code on every row. You still do the work in Linear.
Two ways to connect
- One click. Sign in to Linear and approve read access for Operators. This is the way to use when it is offered.
- Your own key. In Linear, open Settings, then Security and access, and make a new key under “Personal API keys”. Give it Read access only and choose the teams you want on your board, then paste it into Operators. Linear shows the key once. If you remove it in Linear later, the connection stops and Operators asks for a new one.
Both bring in exactly the same issues. Disconnecting deletes the key on our side; remove it in Linear too if you no longer need it.
What does a Linear issue look like on the board?
Each issue shows its number and title, its status, its due date if it has one, who it is assigned to and a link that opens it in Linear. Issues land under the company you chose for that workspace. If one workspace serves several companies, you can file each Linear team under its own company, and anything with no company chosen waits in Unsorted until you file it.
What if an issue has no due date?
It never gets one invented. It shows under the company, not under Due today. If you lose access to a workspace, its issues stay on the board marked “may be out of date” until you reconnect or disconnect.
How to connect Linear
-
Choose the company
On your board, open Tools, pick Linear and choose which company this workspace belongs to. You can route single teams to other companies later.
-
Sign in to Linear, or paste a key
Approve read access for Operators on Linear's screen, or make a read-only personal key in Linear's settings and paste it in. Either way, pick the workspace you want to connect.
-
Check the first issues
Your assigned issues appear shortly. Change the review word if your team uses a different one, then connect your next workspace if you have one.
What we keep from Linear, and what we never keep
We keep, for each item
- Issue number and title
- Status
- Due date
- Assignee name
- Team, to choose the company
- Link
We never keep
- The full text of messages, emails, meeting notes or files
- A copy for training any AI model
- One workspace per sign-in: connect again for each workspace.
The full list for every tool is on the security page. Connecting a client's Linear? Send their IT team this page.
Questions people ask
- Can I connect more than one Linear workspace?
- Yes. Linear signs you in to one workspace at a time, so you connect once per workspace. Each connection can feed a different company on your board, or several.
- Can Operators change my Linear issues?
- No. Operators asks Linear for read access only, and a key you make yourself can be limited to Read. Marking an issue done on your board changes your board, and the issue shows as still open in Linear until someone closes it there.
- Can I connect Linear without the one-click sign-in?
- Yes. Make a personal key in Linear's Security and access settings, give it Read access and the teams you want, and paste it into Operators. The key screen opens the right Linear page for you.
- Which issues count as waiting on me?
- Issues assigned to you whose status name contains the word review. If your team uses another word, change it in the connection's settings.
Related
- Integrations Operators + GitHub: pull requests waiting for your review Connect GitHub to Operators to see pull requests asking for your review, issues with a milestone date and merged work, by company on one board. 2 min read
- Integrations Operators + Notion: tasks assigned to you, by due date Connect Notion to Operators to see the tasks assigned to you in the databases you choose, sorted by company and due date next to the rest of your work. 2 min read
- Guides How to see what is waiting on you across every company Use the Waiting on you section of Today to see every review, approval, signature and reply that only you can clear, across all your companies. 5 min read