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

​
Connecting Linear

1

Navigate to Settings

Go to Settings in the sidebar, then select Integrations
2

Find Linear

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

Start Connection

Click the Linear card to open the connection page, then click Connect Linear Account
4

Authorize Access

You’ll be redirected to Linear to authorize Kasava. Review the permissions and click Authorize
5

Complete Setup

After authorization, you’ll be redirected back to Kasava. The integration status will show as connected
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

​
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

​
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)

​
From Kasava to Linear (Write)

The AI chat can write back to Linear:

​
Roadmap Status Updates

When you drag items in the Roadmap Board view:
  • Status changes are saved locally in Kasava
  • For now, update the issue status directly in Linear for immediate sync

​
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 Views

Switch between three views using the toggle in the header:

​
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.

​
Status Indicators

Linear items display status badges:

​
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. For immediate sync, update the issue status directly in Linear.

​
Field Mapping

​
Priority Mapping

​
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
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

​
Command Arguments

Filter the analysis with natural language:

​
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:
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