Linear — connecting

The Linear connector shows your issues from Linear and lets you comment and change status (workflow state).

Linear is a cloud service (linear.app), so you do not need to enter an instance address.

How to connect (regular user)

1. In the app: Settings → Organizations → organization → Integrations → "+" → Linear (or the Linear tile on the sign-in screen).
2. Tap Connect — a browser opens with the Linear screen.
3. Tap Authorize — the app gets access, and you return to Taskloc.
4. The issues will appear in the list.

What it can do

• Creating an issue — ✅, the "+" button on the task list; the team is chosen in the form (more).
• Comments.
• Status change — the issue's workflow state (Todo / In Progress / Done…).
• Labels, teams as the task container.
• Attachments — files and photos to an issue (including several photos at check-in).

What is not supported

Time is not written to Linear — Linear has no time tracking in its API. The duration of GPS sessions and the timer is saved in Taskloc and is visible in the app's reports (as with GitHub).

• Time entries to the tracker (Linear has no time tracking).
• Auto-pause of an idle session in the tracker.
• Assigning an assignee from the app. The connector does not write the assignee: Linear expects a string user identifier (UUID), and the app does not send it. If you change the assignee in the app, the change is silently lost — there will be no error, but in Linear the issue stays with the previous person. The assignee is visible in the list and in the card; change it in Linear itself. The "Assign the task to me on start" switch does not work for Linear for the same reason.

For the administrator

The Linear OAuth app is registered once — the Taskloc team does it. End users only tap "Connect": they do not need to copy keys.

The administrator guide (creating the app, callback URL, scopes) is the internal document docs/setup-trackers/setup-Linear-for-Taskloc.md. If you deploy Taskloc yourself, request it from the Taskloc team.