Skip to main content
With Linear connected, your agents can read and update Linear issues and projects as you. For how connectors work across services, see Let your agents use your services.

Before you begin

  • Linear turned on for your workspace. See Turn on connectors for your workspace.
  • The Linear account you want agents to use, signed in to the workspace they should work in.
  • Agents can change anything your Linear account can. Switch asks Linear for read and write access, so every connection can write.
  • Whether the agent asks for approval. It depends on the agent’s provider and settings. See Check whether an agent asks for approval.

Connect Linear

1

Start the connection

In the Switch Console sidebar, select Connectors, then the Discover tab. Select Linear, then Connect to Switch. Your browser opens, and Switch Console waits while you sign in.
2

Allow access

Sign in at Linear with the account your agents should use, and allow access. If your browser is already signed in to Linear and has allowed Switch before, Linear may skip this page and connect that account.
3

Return to Switch Console

When the page says you’re connected, close the tab. The Linear page in Switch Console shows the account you connected as.
Then turn Linear on for each agent that needs it. See Turn a connector on for an agent. To check that Linear works, start a new session with the agent, then ask the agent something small, such as list the issues assigned to me.

Cut off access

To stop one agent, open the agent’s page, select the plug icon, and turn Linear off. To stop every agent, on the Linear page under Connectors, select Disconnect.
  • Turning Linear off for an agent: Access the agent already holds keeps working for up to about 24 hours.
  • Disconnecting: Switch revokes your Linear sign-in, so access agents already hold may stop at once.

Troubleshooting

Your browser connected the Linear login it was already signed in to. On the Linear page in Switch Console, select Disconnect. Sign in to the right account and workspace at Linear, then connect again.

Next steps

Let your agents use your services

Connect another service, or check how approvals and cutting off access work