Linear — connecting
Connect Linear to Taskloc with one-click OAuth — issues, comments, workflow states, labels and attachments; Linear has no time tracking, time stays in Taskloc
Updated:
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.
Does Taskloc log time to Linear?
No: hours do not go to Linear, they stay in Taskloc. The duration of GPS sessions and the timer is visible in the app's and the web dashboard's reports.
Why: Linear has no time tracking — its API (GraphQL) has no time entry (worklog) entity to write hours to.
What Taskloc adds on top of Linear issues: the GPS route of a trip per issue, an on-site check-in (location, geofence, photos) and time per issue — in Taskloc reports.
How to connect (regular user)
- In the app: Settings → Add tracker → Linear (with several organizations — Settings → All trackers (N) → Add tracker; or the Linear tile on the sign-in screen).
- Tap Connect — a browser opens with the Linear screen.
- Tap Authorize — the app gets access, and you return to Taskloc.
- The issues will appear in the list.
Access renews on its own: the app keeps Linear's refresh token on the device and uses it to extend access without opening the sign-in screen again. You only need to sign in again if Linear revokes the granted access.
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 entries to the tracker — time stays in Taskloc (why).
- 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.