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.
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
Agents are using the wrong Linear account or workspace
Agents are using the wrong Linear account or workspace
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

