Skip to main content
Linear is a modern issue tracking platform popular with engineering teams. Kasava’s Linear integration enables AI-powered issue management and brings your Linear issues into your product roadmap.

​
Capabilities

FeatureDescription
AI Issue ManagementCreate and update Linear issues using natural language in chat
Plans IntegrationEmbed live Linear issues directly in your planning documents
Roadmap IntegrationView Linear items alongside other platforms in your product roadmap
Bi-Directional SyncRead issues from Linear, write updates back via AI chat
Search & FilterSearch and filter Linear issues across your workspace
Team AssignmentAssign issues to team members from Kasava
Status TrackingTrack issue status, priority, and progress

​
Connecting Linear

1

Navigate to Settings

Go to Settings in the sidebar, then select IntegrationsSettings navigation with Integrations highlighted
2

Find Linear

In the Task Management section, locate the Linear integration cardLinear integration card in Task Management section
3

Start Connection

Click the Linear card to open the connection page, then click Connect Linear AccountLinear integration page with Connect button
4

Authorize Access

You’ll be redirected to Linear to authorize Kasava. Review the permissions and click AuthorizeLinear OAuth authorization screen
5

Complete Setup

After authorization, you’ll be redirected back to Kasava. The integration status will show as connectedConnected status with green checkmark
Kasava uses secure OAuth authentication. Your Linear credentials are never stored—only an access token for API calls.

​
Using Linear in AI Chat

Once connected, you can manage Linear issues using natural language in Kasava’s AI chat:

​
Example Commands

  • “Create a new Linear issue for fixing the login bug”
  • “Show me all high priority Linear issues”
  • “Assign the authentication issue to Sarah”
  • “Update the payment feature status to in progress”
  • “Find Linear issues related to the API”
The AI assistant will interact with your Linear workspace to create, update, and search issues based on your requests.

​
Personalized with AI Learning

When Kasava analyzes Linear issues, it applies your AI Learning patterns to provide personalized results:
  • Issue categorization follows your preferences
  • Priority recommendations match your team’s thresholds
  • Terminology uses your preferred terms
If you’ve corrected how Kasava categorizes certain types of issues, those corrections are remembered and applied to future Linear issue analysis.

​
Embedding Linear Issues in Plans

You can embed live Linear issues directly into your Plans to keep planning documents connected to implementation work.

​
Inserting a Linear Issue

  1. Open a Plan in the editor
  2. Type /linear or click the + button and select Linear Issue
  3. Search for the issue by title, identifier, or description
  4. Click to insert the issue block
Plan editor with Linear issue selector

​
Linear Issue Block

The embedded issue displays live data from Linear:
  • Status icon - Shows current workflow state (Todo, In Progress, Done)
  • Identifier - Clickable link (e.g., ENG-123) that opens in Linear
  • Title - The issue title
  • Assignee - Team member assigned to the issue
  • Priority - Urgent, High, Medium, or Low badge
  • Labels - Color-coded labels from Linear
Linear issue block embedded in a Plan

​
Keeping Plans in Sync

Embedded Linear issues stay connected to your Linear workspace:
  • Issue data refreshes when you view the Plan
  • Click the issue identifier to open it directly in Linear
  • Changes made in Linear (status, assignee, priority) are reflected in the Plan
Use embedded Linear issues to connect your PRDs and planning documents to the actual implementation tickets your team is working on.

​
Bi-Directional Sync

Kasava supports syncing with Linear to keep your work aligned across platforms.

​
From Linear to Kasava (Read)

What SyncsHow It Works
IssuesAppear in Roadmap view and can be embedded in Plans
StatusMapped to Kasava’s status system (Planned, In Progress, Completed)
PriorityMapped to Kasava’s priority levels
AssigneesDisplayed with names and avatars
LabelsShown with original colors
Teams & ProjectsUsed for filtering and organization

​
From Kasava to Linear (Write)

The AI chat can write back to Linear:
ActionWhat Happens in Linear
Create issueNew issue created in specified team/project
Update issueIssue fields modified (title, description, priority)
Change assigneeAssignee updated on the issue
Add commentComment added to the issue thread

​
Roadmap Status Updates

When you drag items in the Roadmap Board view:
  • Status changes are saved locally in Kasava
  • A notification indicates that full two-way sync is coming soon
  • For now, update the issue status directly in Linear for immediate sync
Full bi-directional sync for roadmap status changes is in development. Currently, AI chat commands provide the most complete two-way functionality.

​
Best Practices for Sync

  1. Use AI chat for updates - The most reliable way to push changes back to Linear
  2. Refresh regularly - Embedded issues and roadmap items fetch latest data on view
  3. Link related items - Connect Linear issues to roadmap items for better tracking
  4. Keep one source of truth - For critical status updates, make changes in Linear directly

​
Viewing Linear in Roadmap

Linear issues appear in your product’s Roadmap tab, alongside items from other connected platforms.

​
Accessing the Roadmap

  1. Navigate to your Product
  2. Click the Roadmap tab
  3. Linear items will display with a Linear badge
Roadmap tab showing items from multiple platforms

​
Roadmap Views

Switch between three views using the toggle in the header:
ViewDescription
ListSortable list showing all roadmap items with details
TimelineGantt-style timeline view with date ranges
BoardKanban board with columns for Planned, In Progress, and Completed
View toggle with List, Timeline, and Board options

​
Filtering by Platform

To view only Linear items:
  1. Click the Filters button
  2. Under Platform, check Linear
  3. The view will update to show only Linear-sourced items
You can also filter by status: In Progress, At Risk, Delayed, Planned, or Completed. Filter dropdown with platform options

​
Status Indicators

Linear items display status badges:
StatusIndicator
PlannedGray badge
In ProgressBlue badge
On TrackGreen checkmark
At RiskYellow warning
DelayedRed indicator
CompletedGreen badge

​
Updating Status

Drag items between columns in Board view to update their status:
  1. Switch to Board view
  2. Drag an item from one column to another
  3. The status updates locally
Status changes made in Kasava are saved locally. Full two-way sync with Linear is coming soon—you’ll see a notification when moving external items.

​
Field Mapping

Linear FieldKasava Display
Issue titleItem name
DescriptionItem description
StateStatus column
PriorityPriority badge
LabelsLabel chips
Due dateTarget date

​
Priority Mapping

Linear PriorityKasava Priority
UrgentCritical
HighHigh
MediumMedium
LowLow
No priorityNone

​
Creating Roadmap Items

You can create new roadmap items directly in Kasava:
  1. In the Roadmap tab, click Add Item
  2. Choose the item type:
    • Epic - Large initiative with multiple features
    • Feature - Specific functionality to build
    • Milestone - Point in time when work must complete
    • Release - Version shipping to users
    • Sprint - Time-boxed execution period
  3. Fill in the details and click Create
Add Item dropdown showing item types
Items created in Kasava are native Kasava items. To create issues directly in Linear, use the AI chat or the Linear app.

​
@kasava Commands in Issues

Use @kasava mentions in Linear issue comments to trigger AI-powered actions directly from your workflow.

​
How It Works

  1. Add a comment on any Linear issue with @kasava followed by a command
  2. Kasava detects the mention via webhooks
  3. The AI processes your request using the issue context
  4. Results are posted as a reply comment on the issue

​
Available Commands

CommandDescription
@kasava summarizeSummarize the issue discussion
@kasava documentGenerate documentation from the issue
@kasava planCreate an implementation plan
@kasava design-docGenerate a design document
@kasava prototypeCreate a prototype spec
@kasava diagnoseAnalyze the problem described
@kasava postmortemGenerate a postmortem analysis
@kasava insightsExtract key insights
@kasava changelogGenerate changelog entries
@kasava reportCreate a status report
@kasava review-prepPrepare for a review meeting

​
Command Arguments

Filter the analysis with natural language: 
@kasava summarize last 5 comments
@kasava summarize since last week
@kasava summarize by @alice

​
Custom Commands

Your organization can create custom action types in Settings > Templates > Action Types that work in Linear just like built-in commands.

​
Authorization

By default, Linear workspace members in your Kasava organization can use commands. Enable external collaborators in Settings > Integrations > Permissions if needed.
Use @kasava summarize on lengthy Linear issues to quickly generate a summary of the discussion for stakeholders.

​
Disconnecting Linear

To disconnect your Linear workspace:
  1. Go to Settings → Integrations
  2. Click on the Linear integration
  3. Click Disconnect Linear
  4. Confirm the disconnection
Your existing roadmap data will remain in Kasava, but new syncs will stop.

​
Troubleshooting

Verify that Linear is connected by checking Settings → Integrations. The connection status should show a green checkmark. If disconnected, reconnect using the OAuth flow.
Ensure you have permission to authorize applications in your Linear workspace. If you’re not a workspace admin, contact your Linear administrator.
Make sure your Linear connection is active. Try disconnecting and reconnecting the integration. The AI assistant requires an active connection to interact with Linear.
Status mapping between Linear and Kasava may differ. Linear’s workflow states are mapped to Kasava’s status system (Planned, In Progress, Completed). Check the item details for the original Linear state.

​
Permissions

Kasava requests the following Linear permissions during OAuth:
PermissionPurpose
Read accessView issues, projects, teams, and users
Write accessCreate and update issues from AI chat
Admin permissions are not required. Kasava only accesses data within the scope you authorize.

Plans

Create plans with embedded Linear issues

Products

Manage products and view roadmaps

AI Chat

Use AI to manage Linear issues

AI Learning

Customize how AI analyzes issues