All Docs
FeaturesSidekickUpdated March 11, 2026

Linear Integration

Linear Integration

Sidekick's Linear adapter connects your AI agent to your Linear workspace, enabling autonomous issue tracking, project management, and team workflow automation — no manual context-switching required.

What You Can Do

CapabilityDescription
Create issues from conversationsAgent reads a chat message or email thread and opens a properly titled and described Linear issue.
Update issue statusesAgent transitions issues through your configured workflow states.
Sprint summariesAgent fetches and summarises current sprint progress, blockers, and completed items on demand.

Connecting Linear

  1. Go to Settings → Integrations in your Sidekick dashboard.
  2. Find Linear in the integrations list and click Connect.
  3. Authorise Sidekick via the Linear OAuth flow. You will be asked to grant access to your workspace.
  4. Once connected, choose which teams and projects the agent is allowed to read from and write to.
  5. Click Save. Your agent will begin using Linear automatically.

Permissions note: Sidekick requests the minimum Linear scopes needed — issues:read, issues:write, and projects:read. It does not request admin or billing access.

Autonomous Actions

Creating Issues from Conversations

When the agent detects an actionable task in a conversation (e.g. a Slack message, email, or direct instruction), it can create a Linear issue on your behalf.

Example prompt:

Turn the bug report Alice just sent in Slack into a Linear issue and assign it to the backend team.

The agent will:

  • Extract the title and description from the source message.
  • Set the team, project, and priority based on your configured defaults or explicit instructions.
  • Post the new issue URL back to you as confirmation.

Updating Issue Statuses

Example prompt:

Mark issue ENG-412 as In Progress.

The agent will locate the issue and apply the requested workflow state transition.

Sprint Summaries

Example prompt:

Give me a summary of the current sprint for the Platform team.

The agent will return:

  • Total issues in the sprint and their current state breakdown.
  • Issues marked as blocked or overdue.
  • Issues completed since the sprint started.

Default Behaviour & Configuration

  • Default team: If no team is specified in a request, the agent uses the first team connected during setup. You can change this under Settings → Integrations → Linear → Defaults.
  • Write guard: By default, the agent will ask for confirmation before creating or modifying issues. You can disable this per-team under Settings → Agent Autonomy.
  • Notification routing: Issue creation confirmations are sent via whichever channel triggered the action (e.g. Slack thread, email reply).

Availability

The Linear integration is available on all Sidekick plans. No API keys are required — authentication is handled entirely through OAuth.