Integrations

Linear

beta

Connect Linear as a permission-scoped source, then explicitly turn individual cached issues into HiveBase tasks.

Last updated 2026-07-23

Linear is HiveBase's task-tool beachhead and a source-first integration. HiveBase keeps Linear data owned by Linear, observes verified changes into a permission-scoped cache, and lets you explicitly create or link a HiveBase task from an individual cached issue.

Connecting maps authorized teams only. It does not browse an entire workspace, bulk-import projects, start Brain seeding, or silently turn Linear events into HiveBase tasks. Connect ≠ watch ≠ Brain ≠ writeback.

What happens when you connect

HiveBase completes the Linear OAuth flow and verifies the returned account and workspace.
It records only the teams that authorization can access. Connecting Linear does not install or enable Linear Agent.
Verified Linear webhooks can update HiveBase's private source cache.
When you choose Browse cached Linear issues, HiveBase shows only issues it has already observed and that you are still allowed to see.
You can choose Create HiveBase Task for one issue, or link that issue to an existing task. The task keeps Linear as an explicit source.

No provider-wide import

Connecting Linear does not enumerate its teams or projects, bulk-import a workspace, or start a full Brain seed. The source picker reads HiveBase's existing cache only; it does not make a Linear API request.

What stays in Linear

Data or action	Current behavior
Issues, projects, cycles, comments, and relationships	Remain Linear-owned source data. HiveBase retains a permission-scoped cache of verified objects.
Changes after a task is created	Appear as source context or drift; they do not silently overwrite the HiveBase task.
Creating, updating, assigning, or commenting on Linear issues	Not live yet. Fail-closed until each action is live-certified on the journaled path. No live comments.
Delegating work to Linear's agent	Disabled. A provider session cannot start or advance a HiveBase agent workflow.
Scheduled Brain enrichment	Off by default and available only after an explicit workspace setting is persisted.

Connect Linear

Open Integrations

In HiveBase, go to Settings → Integrations → Data Sources.

Connect Linear

Find Linear and select Connect Linear. Complete Linear's authorization screen for the account and workspace you intend to use.

Browse cached issues when ready

Back in HiveBase, select Browse cached Linear issues. This is an intentional action; it does not fetch a workspace from Linear.

Create or link one task

Choose an eligible cached issue and create a HiveBase task, or link it to work that already exists in HiveBase.

Disconnecting and your data

Disconnecting stops future access and revokes the affected connection. Cached objects and source bindings remain subject to their visibility and lifecycle rules; HiveBase does not use a disconnected credential to refresh them.

FAQ

Does connecting Linear import my projects?

No. HiveBase does not bulk-import Linear projects or browse a workspace on connection. You can intentionally work from individual cached issues that HiveBase has already observed and that you can access.

Will a Linear update overwrite my HiveBase task?

No. After explicit promotion or linking, later Linear changes remain source context and drift evidence. They do not silently update the HiveBase task.

Can HiveBase write back to Linear today?

Not live yet. Creating or updating issues, posting comments, assignments, and delegation are fail-closed. Nothing is exposed as live writeback until each action is live-certified on the journaled policy and receipt path. Do not expect live Linear comments from HiveBase today.

Does HiveBase run Linear's agent?

No. Linear Agent OAuth and Agent webhook resource types are absent from HiveBase's application configuration. Any future capability would require certified execution custody and journaled authority before it is exposed.