Skip to content

For the complete documentation index, see llms.txt.

PromptlessPromptless Documentation
Get a demoStart for free

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 a context source

Section titled “How it works as a 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

Section titled “Example”

Linear positions itself as the product development system—the place where teams plan and track work from idea to launch—so a Linear issue usually holds the intent behind a change, not just a task title.

A developer merges a GitHub PR that links to ENG-238, the Linear issue behind a new scheduled-reports feature. The issue captures the intent the diff doesn’t: reports can be scheduled daily or weekly, they’re delivered to a Slack channel rather than email, and the feature is gated to workspaces on the Business plan.

When Promptless picks up the merged PR, it retrieves ENG-238 and searches Linear for related issues in the same project. It reads the issue and carries that context into the documentation suggestion—the scheduling cadences, the Slack delivery, and the plan gating—so the docs explain what users can do and who has access, not just the code that shipped.

Configuration

Section titled “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.

Data privacy

Section titled “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

Section titled “Setup instructions”

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