Linear

Connect Linear, choose the team new issues go to, and send a request to Linear as an issue.

On this page

Connect Linear

  1. In Connect › Linear, select Connect.

  2. Linear opens its own approval screen for Cactus. Cactus asks Linear for read and issues:create, and is installed in the workspace as an app.

  3. Approve it. Linear brings you back to Connect › Linear, where the row shows the workspace's name.

If Linear lists only one team, Cactus chooses it for you. Otherwise, choose one as the next section says.

The setup conversation offers the same connection as a step named Requests to Linear, which you can skip with Not now.

Choose the team new issues go to

Each connected workspace sends new issues to one team. Choosing it is saved as soon as you pick it.

  • In Connect › Linear, select the workspace's badge on the Linear row.
  • Under New issues go to, select the team.
  • The row saves the team when you pick it.

The teams listed are the teams Linear shows to Cactus.

Send a request to Linear

In Conversations, select Send on a request's row. It appears when you point at the row or move focus onto it. Where no Linear connection exists, Send to Linear offers Connect instead.

The send popover has two tabs: New issue and Add to existing.

Create a new issue

  1. On New issue, check the Title, which starts as the request's title.

  2. Choose the Team, which starts on the team chosen for new issues.

  3. Select Create issue, or press Ctrl or Cmd with Enter.

The issue carries up to the latest three of the people's own requests, with their dates, and a link back to Cactus. The Cactus app creates the issue and names you as the person who sent it.

Add to an existing issue

  1. On Add to existing, search by words, or paste a Linear issue link or an identifier such as ENG-142, which finds that issue in any team.

  2. Pick the issue in the results. The issue the request is already on is listed first.

After a send

A notice says Sent to Linear as the issue's identifier. It shows only when your press sent something.

If Linear already has the request on an issue, Cactus links the request to that issue and sends nothing.

A request on an issue shows Open with the issue's identifier, and Unlink.

Unlink takes the request off its issue in Cactus. The issue in Linear stays as it is, and the unlink can be undone for a short time.

A request you unlinked is not filed again on its own.

The issue's state in Linear is read again when you open the request, or when the state is over 10 minutes old and someone looks at it. Cactus does not get updates from Linear as they happen.

Requests filed on their own

A request first seen after you connect is filed on its own once a team is chosen. Cactus creates a new issue in that team, as the Cactus app.

A request first seen before you connected is attached only when it is already on an issue.

A request you dismissed is left alone.

Disconnect Linear

  1. In Connect › Linear, select the workspace's badge on the Linear row.

  2. Hold Disconnect with the workspace's name until it confirms.

The menu says Cactus will stop sending to the workspace, and issues already sent stay linked.

Cactus is removed from the whole Linear workspace only when no product still uses the workspace.

Any member of the team can connect, pick a team, send requests and disconnect, because these actions check only that you are on the team.

If Linear stops working

What you see

What it means

What to do

“Linear isn’t connected. Connect it again in Connect › Linear.”

What it means

Cactus is no longer connected to Linear. The workspace's connection is removed for every product.

What to do

Select Connect on Connect › Linear again.

“Couldn’t reach Linear. Try again.”

What it means

Linear did not answer the create.

What to do

Select Create issue again.

“Couldn’t find that team in Linear. Pick another team.”

What it means

The team you picked is not among the teams Linear lists for Cactus.

What to do

Choose another team under New issues go to.

“Couldn’t find that issue in Linear. Check its link or ID and try again.”

What it means

The link or identifier you pasted matches no issue Cactus can see.

What to do

Check the link or identifier, or search by words.

“Couldn’t find this request. Refresh the page and try again.”

What it means

The request is no longer there for Cactus to send.

What to do

Refresh the page.

“Linear isn’t available yet.”

What it means

Linear cannot be connected.

What to do

Nothing to do on your side.

If the trip to Linear does not finish, Connect › Linear comes back with the connection not made. The reasons are that the link expired, Linear's approval was denied, the answer was incomplete, you were signed out, or the connection failed.

Sources

Related pages