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 → Connected Apps
- Find Linear and click Connect 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 / issue_updated / issue_removed
- comment_created / comment_updated / comment_removed
When events fire in Linear, Symbi receives them instantly — your agents can react without polling.
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
Opt-in (write-heavy):
- List Issues
- Create Issue
- List Projects / Cycles
Enable opt-in actions per agent from the Behavior tab.
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 Connected Apps 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 → Tilkoblede apper
- Finn Linear og klikk Koble til 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 / issue_updated / issue_removed
- comment_created / comment_updated / comment_removed
Når hendelser utløses i Linear, mottar Symbi dem umiddelbart — agentene dine kan reagere uten polling.
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)
Opt-in (skrive-tunge):
- List issues (List Issues)
- Opprett issue (Create Issue)
- List prosjekter / sykluser (List Projects / Cycles)
Aktiver opt-in-handlinger per agent fra Oppførsel-fanen.
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 Tilkoblede apper-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