Linear Integration

Connecting Linear lets DevClocked sync your Linear issues and tie them to the actual work that delivered them — the coding sessions and commits already tracked in DevClocked. It's a read-only, OAuth-based connection: DevClocked never changes anything in Linear.

What gets connected

• Linear workspace — you install the DevClocked Linear app into your Linear workspace with a standard OAuth flow. No API keys to copy.
• Issue sync — DevClocked pulls your issues (identifier, title, state, assignee) into a read-only cache it can link work against.
• Evidence links — DevClocked matches issues to your commits and sessions using the issue identifier (e.g. ENG-142) found in branch names, commit messages, and pull request references.

The connection is read-only: writeback is disabled, so DevClocked never comments on, moves, or edits your Linear issues.

Connect Linear

1. Open Settings > Integrations.
2. Find the Linear card and click Install Linear.
3. DevClocked redirects you to Linear's authorization screen.
4. Choose the workspace to connect and click Allow.
5. Linear redirects you back to DevClocked and the card shows Installed.

DevClocked runs a first sync automatically. After that, issues re-sync on a schedule (roughly hourly), and you can trigger an immediate refresh at any time with Sync issues in the Linear dialog.

How issues link to your work

Once issues are synced, DevClocked links them to your tracked work using the Linear issue identifier:

• Branch names — e.g. a branch like eng-142-fix-login.
• Commit messages — e.g. ENG-142 fix token refresh.
• Pull requests — the issue key in the PR, or commits already linked to the issue.

Matched issues appear alongside the sessions and commits that delivered them, so shipped work is tied back to what it was for. GitHub must be connected for commit- and PR-based linking — see Connecting GitHub.

Managing the connection

• Sync issues — force an immediate re-sync of your Linear issues.
• Reinstall Linear — re-run the OAuth flow if the connection needs reauthorising (shown as Needs reinstall).
• Disconnect — remove the connection and stop syncing. Your DevClocked sessions and commits are untouched.

Troubleshooting

The Linear card shows "Sync error".

Open the Linear dialog to see the error detail. A common cause is an expired authorization — click Reinstall Linear to reauthorise.

Issues aren't linking to my commits.

Linking relies on the issue identifier appearing in your branch name, commit message, or PR. Make sure GitHub is connected and the relevant repositories are tracked, and that your branches or commits reference the Linear identifier (e.g. ENG-142).