> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chartcastr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear source

> Connect Linear to Chartcastr for automated issue tracking and project health charts. Monitor cycle progress, team velocity, and backlog trends.

<Info>
  **Paid Feature** — Linear is available on all paid plans (Starter, Pro, Enterprise). [See pricing](https://chartcastr.com/pricing).
</Info>

## Overview

Use Linear as a data source for Chartcastr. Connect your Linear workspace and Chartcastr will pull project management metrics directly from your issues, cycles, and teams — issue velocity, cycle burndown, priority distribution, and more — and deliver them as automated charts to Slack or email.

Chartcastr connects via OAuth to your Linear workspace with read access to issues, cycles, and teams. Chart delivery and AI analysis appear as the **Chartcastr** app in your workspace.

## Setup

<Steps>
  <Step title="Connect your Linear workspace">
    In Chartcastr, go to [Sources](https://chartcastr.com/admin/sources) and select **Linear**. Click **Connect** and complete the OAuth flow. You will be asked to authorise Chartcastr to access your workspace.
  </Step>

  <Step title="Select a metric">
    Choose which project management metric you want to track. Each metric becomes its own pulse source — you can add multiple to send different charts on different schedules.
  </Step>

  <Step title="Create a connection">
    Go to [Connections](https://chartcastr.com/admin/connections) → **New Connection**. Select your Linear source, pick or add a destination (Slack channel or email), set the delivery frequency, and optionally enable AI summaries. Most teams send cycle burndowns weekly and velocity charts at sprint boundaries.
  </Step>
</Steps>

## Available Charts

Chartcastr supports **6 pre-built Linear metrics** across two categories.

<CardGroup cols={2}>
  <Card title="Issues" icon="circle-check">
    Issues created vs completed over time, distribution by status, priority breakdown, and top assignees.
  </Card>

  <Card title="Cycles" icon="arrows-spin">
    Current cycle burndown tracking scope vs completion, and velocity across recent cycles.
  </Card>
</CardGroup>

<Card title="View all available charts" icon="list" href="/integrations/sources/linear/available-charts">
  See the full list of Linear metrics with chart types and descriptions.
</Card>

## Data & Permissions

Chartcastr requests the following Linear OAuth scopes:

| Scope   | Purpose                                                            |
| ------- | ------------------------------------------------------------------ |
| `read`  | Read access to issues, cycles, teams, and project data             |
| `write` | Required for Chartcastr to post AI analysis as comments (optional) |

### What data does Chartcastr access?

* **Issues**: Title, status, priority, assignee, created date, completed date, and estimates.
* **Cycles**: Name, number, start/end dates, progress, and scope history.
* **Teams**: Team name and key for filtering.

Chartcastr does **not** access or store issue descriptions, comments, attachments, or any personal data beyond assignee names.

## Next Steps

<CardGroup cols={2}>
  <Card title="Slack destination" icon="slack" href="/integrations/destinations/slack">
    Deliver Linear charts to your Slack channels with AI summaries in the thread.
  </Card>

  <Card title="Email destination" icon="envelope" href="/integrations/destinations/email">
    Schedule Linear reports to any inbox or distribution list.
  </Card>
</CardGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Does Linear support multiple workspaces?">
    Linear OAuth grants access to a single workspace per connection. If you have multiple workspaces, connect each one separately.
  </Accordion>

  <Accordion title="Which teams are included?">
    By default, Chartcastr aggregates data across **all teams** in your workspace. When adding a source, you can optionally filter by one or more specific teams using the team picker. This filter is saved per source, so you can create separate sources for different teams.
  </Accordion>

  <Accordion title="How often is data refreshed?">
    Data is fetched fresh from Linear every time a pulse fires. Chartcastr does not cache or store your project data between runs.
  </Accordion>

  <Accordion title="What date range is used?">
    Issue trend metrics use the last 12 weeks of data. Cycle velocity shows the last 6 completed cycles.
  </Accordion>

  <Accordion title="How does the Chartcastr app appear in Linear?">
    Chartcastr uses Linear's **actor=app** OAuth mode. Any AI analysis comments or updates posted by Chartcastr appear with the Chartcastr logo, not as an individual user.
  </Accordion>
</AccordionGroup>