Linear
Use Linear setup when your team wants Coldtea tasks and agent work to stay connected to Linear issues.
Linear is a team integration. It depends on TeaHouse access, a Linear workspace you can authorize, and the integration surfaces enabled for your build.
What Linear setup can support
Where enabled, Linear can help with:
- Bringing issue context into Coldtea tasks.
- Keeping task state, assignee, labels, or descriptions aligned with Linear workflows.
- Linking review or agent activity back to the issue that started the work.
- Matcha or QA agent flows that use Linear's agent surfaces, when configured.
Availability depends on the integration your workspace has enabled. Do not treat a missing Linear action as a local agent problem.
Before you connect
Check:
- You are in the right Coldtea TeaHouse.
- You can sign in to the right Linear workspace.
- Your Linear account has access to the team or issues you expect to use.
- Your team knows which system owns task state when sync is enabled.
That last point matters. If both systems can edit title, status, labels, or assignee, the team should know which changes are expected to sync.
Connect Linear
A typical setup flow is:
- Open the Linear integration surface in Coldtea.
- Start the OAuth or install flow.
- Complete the browser handoff with the correct Linear account.
- Return to Coldtea and wait for connection status or sync to finish.
- Open a known issue-linked task and confirm the issue link is present.
After connecting, give sync time to finish before assuming an issue or task is missing.
If sync looks wrong
Check these first:
- You are viewing the expected TeaHouse and team.
- The Linear connection completed in the browser.
- The Linear account has access to the source issue.
- The issue belongs to a Linear team mapped to the Coldtea team, where that mapping is required.
- The task did not come from a different integration or local-only source.
If a task came from Linear, keep review comments and implementation logs readable in Coldtea. The task is still the source of truth for the agent work you are reviewing in the app.
Security note
Linear access follows the connected Linear workspace and account permissions. Coldtea membership alone does not guarantee access to every Linear issue.