Linear logo
Engineering integrationUpdated

Linear cycles and projects on an Apple TV dashboard in the office

Linear is built around cycles and projects, and its progress numbers are the ones product teams quote in every review. Dance Party reads them with read-only access and puts them on an Apple TV dashboard on the office display: each team's current cycle, which projects are near their target date, and the urgent issues nobody has picked up.

  • Read-only
  • OAuth connection
  • One connection per workspace
Cycle 38, Platform teamLive
Cycle progress, ends Friday
68%/ 100%
68% to goal

What teams running Linear put on the screen, and what you would ask DJ Agent to get it.

Current cycle by team

For engineering managers and every team in the room

Each Linear team runs its own cycle, and nobody sees the others. Every team's active cycle progress in one ranked list shows on Wednesday which one is going to carry work into the next cycle.

  • Progress of each team's active cycle
  • Cycle number and end date
  • Issues in the cycle by state: backlog, started, completed

Ask DJ Agent“Rank our Linear teams by progress in their active cycle, with each cycle number and end date.”

Active cyclesLive
1Platform, Cycle 38
68%
2Growth, Cycle 22
54%
3Mobile, Cycle 15
47%
4Design Systems, Cycle 9
31%

Projects and target dates

For product, design, and leadership

Linear projects carry a target date and a progress number, which is most of what a roadmap review covers. Started projects sorted by target date, with the ones behind pace in amber, keep the roadmap honest between reviews.

  • Started projects with progress and target date
  • Project lead and the teams working on it
  • Projects past their target date that are not completed

Ask DJ Agent“List started Linear projects by target date with progress and lead, and flag any past its target date.”

Projects in flightLive
Usage-based billing
Lead: Maya Chen · Oct 10
82%
SSO for enterprise
Lead: Tariq Aziz · Oct 17
61%
iOS widgets
Lead: Sofia Marin · Oct 3
44%
Search rebuild
Lead: Ben Okoro · Sep 26
73%
Onboarding checklist v2
Lead: Ana Lima · Nov 7
12%

Triage and urgent issues

For on-call engineers and team leads

Linear's Urgent priority means drop everything, and it should not sit in Triage. Counts of urgent and high-priority open issues, next to what is waiting in Triage, keep the loudest work visible to the whole team.

  • Open issues with Urgent priority
  • Open issues with High priority
  • Issues waiting in Triage
  • Issues in review

Ask DJ Agent“Count open Linear issues that are Urgent, High priority, in Triage, and In Review for the Platform team.”

Platform queueLive
2
Urgent
9
High
14
Triage
7
In Review

What Dance Party reads from Linear

Dance Party reads Linear through its GraphQL API with the read scope, as the Linear user who connected. It sees the teams, projects, cycles, and issues that user can see, and cannot create or change any of them.

  • Issues
    Identifier, title, state, priority, estimate, assignee, labels, cycle, project, due date, and completed date. Up to 50 per query, filtered by any of those.

Cycles and projects

Linear API docs ↗
  • Cycles
    Number, name, start and end dates, completion, and progress for each team's cycles.
  • Projects
    State, progress, start and target dates, lead, and teams.
  • Teams
    Team key, name, and issue count.
  • Connected user
    Which Linear account the connection belongs to.

How to connect Linear

Before you start

  • An owner or admin of your Dance Party workspace makes the Linear connection.
  • A Linear account in the workspace you want to show. Private teams appear only if that account is a member.
  • No API key. Linear handles sign-in and asks for read access only.
  1. 1
    Find Linear on the Dance Party Integrations page.
  2. 2
    Click Connect Linear. Linear opens its authorization page.
  3. 3
    If you belong to more than one Linear workspace, pick the one to show, then approve read access.
  4. 4
    Back in Dance Party, the Linear card now reads Connected.
The Linear integration card in Dance Party, marked Not connected, with a Connect Linear button
Captured from the Dance Party app, September 30, 2026.

One Linear connection per workspace

A workspace connects one Linear workspace through one person's sign-in. Dashboards see what that person sees in Linear, so connect with an account that is on every team you want on screen.

Read-only. Dance Party requests Linear's read scope, which cannot create, edit, or delete anything. Revoke it from your Linear account settings under Security and access, or disconnect from the Integrations page.

From Linear to your office display

Once Linear shows Connected, the rest happens in plain English. No code, no drag-and-drop.

  1. 1. Describe it. Tell DJ Agent what you want to see.

    New dashboard+ Widget
    Describe a widget in DJ Agent, or click + Widget
    DJ Agent
    DATA SOURCES
    Linear logoLinearConnected
    Rank our Linear teams by progress in their active cycle, with each cycle number and end date.Send
  2. 2. It gets built. The widget lands on your board with real Linear data.

    New dashboard+ Widget
    Linear logoActive cyclesLive
    1Platform, Cycle 38
    68%
    2Growth, Cycle 22
    54%
    3Mobile, Cycle 15
    47%
    4Design Systems, Cycle 9
    31%
    DJ Agent
    DATA SOURCES
    Linear logoLinearConnected
    Rank our Linear teams by progress in their active cycle, with each cycle number and end date.Send
  3. 3. Put it on a screen. Pair an Apple TV with the six-character code it shows, then assign the dashboard.

    The Pair your Apple TV card in Dance Party, with six boxes for the code the Apple TV shows

Linear dashboard questions

Can I show a Linear cycle on a TV in the office?

Yes. Connect Linear, ask for the active cycle of a team, and assign the dashboard to an Apple TV running Dance Party. It refreshes on its own.

Does the progress match what Linear shows?

Yes. Dance Party reads the progress Linear calculates for each cycle and project, so the number on the screen is Linear's own.

Can I show several Linear teams on one screen?

Yes. One connection covers every team the connecting user can see, and each widget can show a different team or all of them.

Can it show a burn-up chart or cycle velocity?

No. Dance Party reads current cycle progress and issues, not the history behind Linear's charts.

Does Linear need an API key for Dance Party?

No. You sign in to Linear and approve read access. There is no personal API key to create or paste.

Can Dance Party create or move Linear issues?

No. The read scope cannot write. It cannot create issues, change states, or edit projects or cycles.

Put Linear on every office display

Connect Linear, describe the dashboard, and it runs on an Apple TV, refreshing on its own.

Get Started