Connecting Linear
Connect Linear so your agents can track issues, comment on tickets, and keep your team's project management in sync.
What Linear Enables
Once connected, your company agents can:
- Read issues — get issue details, list issues by status or project, read comments
- Comment on issues — add updates, triage notes, or AI-generated summaries
- Update issues — change status, priority, labels, or assignee
- Create issues — open new tickets from events elsewhere (e.g., a bug mentioned in a support ticket)
- Browse projects and cycles — find the right project to file work into
Linear is a company-only integration today. Your Personal Assistant does not have direct Linear access.
Connect via OAuth
- Open Settings → Connectors and click the Linear tile
- Click Connect with Linear
- You'll be redirected to Linear's authorization page
- Review the permissions and click Authorize
- Symbi captures your organization ID and the connection is confirmed
Only Owner and Admin users can connect Linear.
Real-Time Webhooks
Symbi automatically subscribes to Linear webhook events:
- issue_created — a new issue is filed
- issue_updated — an existing issue changes
- comment_created — a comment is posted on an issue
When these fire in Linear, Symbi receives them instantly — your agents can react without polling. Deletions and comment edits are not delivered.
Default vs. Opt-In Actions
To keep agents safe by default, actions are split into two groups:
Default (safe actions):
- Add Comment
- Update Issue
- Get Issue
- List Comments
Off by default:
- List Issues
- Create Issue
- List Projects / Get Project / List Cycles
Switch these on per agent from the What it does section on the agent's page. Note that most of them are reads — the split is about noise and scope, not only about write risk. Create Issue is the one that writes.
Feedback-Loop Protection
If an agent writes to Linear and that write would trigger the agent again (e.g., the agent comments on an issue and Linear fires a comment_created webhook), Symbi detects self-triggered events and ignores them — preventing infinite loops.
Common Patterns
- Support → Engineering hand-off — a support agent that creates a Linear issue when a ticket mentions a confirmed bug, linking back to the original FreshDesk ticket
- Triage agent — an agent that labels, prioritizes, and routes new issues based on description and attached metadata
- Daily status — a scheduled agent that summarizes yesterday's issue activity across a project and posts it to Slack
Security
Linear credentials are OAuth 2.0 tokens with refresh rotation. Tokens are AES-256 encrypted. You can revoke access any time from Linear's workspace settings or from Symbi's Connectors page.
Tip
Start with the default action set and add opt-in actions only when you have a clear use case — agents with broad write access in a project management tool can create a lot of noise if they misfire.
What's Next?
- Connect a support integration like FreshDesk to feed work into Linear
- Connect Slack for review notifications on agent activity
- Learn how agents work end to end
Hva Linear muliggjør
Når tilkoblingen er på plass, kan selskapsagentene dine:
- Lese issues — hente issue-detaljer, liste issues etter status eller prosjekt, lese kommentarer
- Kommentere på issues — legge til oppdateringer, triage-notater eller AI-genererte oppsummeringer
- Oppdatere issues — endre status, prioritet, etiketter eller tildelt person
- Opprette issues — åpne nye saker fra hendelser andre steder (f.eks. en bug nevnt i en supportsak)
- Bla gjennom prosjekter og sykluser — finne riktig prosjekt å registrere arbeid i
Linear er i dag en selskapskun-integrasjon. Den Personlige Assistenten din har ikke direkte tilgang til Linear.
Koble til via OAuth
- Åpne Innstillinger → Koblinger og klikk på Linear-flisen
- Klikk Connect with Linear
- Du blir videresendt til Linears autorisasjonsside
- Gå gjennom tillatelsene og klikk Autoriser
- Symbi fanger opp organisasjons-ID-en din og tilkoblingen bekreftes
Kun Eier- og Administrator-brukere kan koble til Linear.
Sanntids-webhooks
Symbi abonnerer automatisk på Linear webhook-hendelser:
- issue_created — en ny issue opprettes
- issue_updated — en eksisterende issue endres
- comment_created — en kommentar publiseres på en issue
Når disse utløses i Linear, mottar Symbi dem umiddelbart — agentene dine kan reagere uten polling. Slettinger og kommentarendringer leveres ikke.
Standard- vs. opt-in-handlinger
For å holde agenter trygge som standard, er handlinger delt inn i to grupper:
Standard (trygge handlinger):
- Legg til kommentar (Add Comment)
- Oppdater issue (Update Issue)
- Hent issue (Get Issue)
- List kommentarer (List Comments)
Av som standard:
- List Issues
- Create Issue
- List Projects / Get Project / List Cycles
Slå disse på per agent fra What it does-seksjonen på agentens side. Merk at de fleste av dem er lesinger — skillet handler om støy og omfang, ikke bare om skriverisiko. Create Issue er den som skriver.
Beskyttelse mot tilbakemeldingssløyfer
Hvis en agent skriver til Linear og denne skrivingen ville utløst agenten igjen (f.eks. agenten kommenterer på en issue og Linear utløser en comment_created-webhook), oppdager Symbi selvutløste hendelser og ignorerer dem — noe som forhindrer uendelige sløyfer.
Vanlige mønstre
- Support → Engineering-overlevering — en supportagent som oppretter en Linear-issue når en sak nevner en bekreftet bug, med lenke tilbake til den opprinnelige FreshDesk-saken
- Triage-agent — en agent som etiketterer, prioriterer og ruter nye issues basert på beskrivelse og tilknyttede metadata
- Daglig status — en planlagt agent som oppsummerer gårsdagens issue-aktivitet på tvers av et prosjekt og publiserer det til Slack
Sikkerhet
Linear-legitimasjon er OAuth 2.0-tokens med rotasjon av oppdateringstokens. Tokens krypteres med AES-256. Du kan oppheve tilgangen når som helst fra Linears arbeidsområdeinnstillinger eller fra Symbis Koblinger-side.
Tip
Start med standardhandlingssettet og legg kun til opt-in-handlinger når du har en tydelig brukstilfelle — agenter med bred skrivetilgang i et prosjektstyringsverktøy kan skape mye støy hvis de feiler.
Hva er neste?
- Koble til en supportintegrasjon som FreshDesk for å mate arbeid inn i Linear
- Koble til Slack for gjennomgangsvarsler om agentaktivitet
- Lær hvordan agenter fungerer fra ende til ende