Skip to main content
When the brief says “audit the backlog” and you want it on the team’s plate, the → Linear button on every pending action creates a Linear issue with one click. No copy-paste, no context switch.

​
Connect Linear

Linear uses a personal API key (or workspace OAuth token) rather than the OAuth dance Intercom uses, so set-up is a single paste.
1

Generate an API key in Linear

In Linear, click your avatar (top left) → Settings → API → Personal API keys → New API key. Name it Forepost. Copy the key (lin_api_…). Linear shows it once.
2

Paste it into Forepost

In Settings → Integrations → Linear, paste the key into the field and Save. Forepost validates against Linear’s viewer query, captures your org name, and stores the key encrypted at rest (same AES-GCM pattern Intercom uses).
3

Confirm with a test file

Open a Daily Brief with at least one pending action and click → Linear next to the action. The button turns into ✓ Linear with a link to the created issue.

​
What gets filed

Each Linear issue Forepost creates carries:
  • Title — the action text from the brief, truncated to 80 characters if needed.
  • Description — the full action text, followed by Filed from Forepost · action #N · app.forepost.ai.
  • Team — by default, the first team your API key has access to. Most Forepost users only have one Linear team in scope; if you have multiple, the SPA will eventually let you pick. For now, edit the issue’s team in Linear after filing if needed.
No labels, no priority, no assignee — Forepost stops at “make the issue exist”. Triage stays in Linear.

​
What it can’t do

  • No two-way sync. Filing an action as a Linear issue does NOT change the action’s status in Forepost. Mark it taken or dismissed in Forepost separately. The intent is that filing-to-Linear is the delegation step; marking it taken in Forepost is the delegated acknowledgement.
  • No automatic close-out. When the Linear issue ships, Forepost doesn’t notice. The next brief’s outcome attribution will pick up the metric movement, but the action’s status stays whatever you set it to in Forepost.
  • No backwards-fill. Actions filed before you connected Linear can’t be retroactively wired up. The button only renders on pending actions; restore an action from dismissed if you want to re-queue it.

​
Disconnecting

Settings → Integrations → Linear → Disconnect. The encrypted API key is deleted immediately. Existing Linear issues stay where they are — Forepost has no scope to retract issues it filed. To revoke the key entirely (so a leaked token can’t be reused), also revoke it from Linear → Settings → API → Personal API keys.

​
Privacy

Forepost stores only the API key (encrypted) and your Linear organisation ID + name. We don’t sync your Linear backlog into Forepost; we don’t read issues; we don’t subscribe to webhooks. Every call is on-demand at the moment you click → Linear. If you’d rather not store a long-lived key, use a Linear OAuth token (also accepted, starts with lin_oauth_…) and revoke it from Linear when you want to.