Linear

Linear integration provides read-only access to your project management data for documentation automation. When Linear is configured as a context source, Promptless can search for related issues to understand the business context behind code changes—but it never modifies your Linear issues.

How It Works as Context Source

When Linear is enabled as a context source:

• Automatic Issue Lookup: When a GitHub PR mentions a Linear issue, Promptless automatically retrieves that issue for additional context
• Proactive Searches: Promptless can search Linear for related issues and projects to understand feature requirements
• Business Context: Linear issues provide the “why” behind code changes, not just the “what”

Example

When a GitHub PR mentions a new feature, Promptless searches Linear for related issues to understand additional project context. This ensures your documentation includes business requirements and feature goals alongside technical implementation details.

Configuration

Configure Linear scope in your Configuration page using the context_sources section:

context_sources:
  linear:
    source_type: linear
    team_keys:
      - engineering
      - product

An empty entry (or no entry) gives Promptless access to all teams. Add team_keys only when you need to restrict which teams Promptless can search.

Note

Promptless inherits the permissions of the Linear account used during OAuth connection and only searches teams you configure.

Data Privacy

Promptless queries Linear data in real-time and does not store any of your Linear data. All searches are performed on-demand when documentation updates are needed. Promptless only reads from Linear—it never creates, updates, or deletes issues.

Setup Instructions

To connect Linear to Promptless, see the Linear Integration setup guide.