Skip to main content
← back to extensions

Linear

@mgreten/linearv2026.08.25.1· 1mo agoMODELS
01README

Linear project management integration for swamp — issue CRUD with fail-closed verified deletion, sub-issue (parent) and estimate support, single-call epic creation (parent + child sub-issues), viewer auto-assignment, label management by name, comment threads, document and project-resource retrieval, and team/project/state listing via the official @linear/sdk.

02Release Notes

Add read-only Linear document lookup by URL and paginated project Resources retrieval for documents and external links.

03Models1
@mgreten/linearv2026.08.25.1linear.ts
fn getViewer()
Resolve the authenticated user's ID, name, and email
fn createMyIssue(title: string)
Create an issue auto-assigned to the authenticated user with team/project defaults
ArgumentTypeDescription
titlestringIssue title
fn getIssue()
Fetch a single issue by identifier (e.g. ENG-123) or UUID
fn updateIssue(title?: string, description?: string, stateId?: string, assigneeId?: string, projectId?: string)
Update fields on an existing issue
ArgumentTypeDescription
title?stringNew title
description?stringNew description
stateId?stringNew workflow state ID
assigneeId?stringNew assignee user ID
projectId?stringNew project ID
fn deleteIssue(confirm: literal)
Permanently delete one issue only after its live identifier and team match the caller's expectations
ArgumentTypeDescription
confirmliteralExplicit destructive-action confirmation; must be "delete"
fn listIssues(projectId?: string, labelName?: string)
Query issues with filters
ArgumentTypeDescription
projectId?stringFilter by project ID
labelName?stringFilter by label name
fn addLabels(labels: string)
Attach labels to an issue by name (additive — preserves existing labels)
ArgumentTypeDescription
labelsstringComma-separated label names to add
fn listLabels()
List available labels for a team
fn createIssue(title: string, projectId?: string, stateId?: string, assigneeId?: string)
Create an issue with full control over all fields
ArgumentTypeDescription
titlestringIssue title
projectId?stringProject ID
stateId?stringWorkflow state ID
assigneeId?stringAssignee user ID
fn createEpic()
Create an epic: a parent issue plus N child sub-issues linked to
fn listTeams()
List all Linear teams and sync them as resources
fn listProjects()
List Linear projects, optionally filtered by team or name substring
fn getDocument()
Fetch a Linear document by UUID, slug ID, or canonical document URL
fn listProjectResources(projectId: string)
Fetch all documents and external links in a Linear project's Resources section
ArgumentTypeDescription
projectIdstringLinear project UUID
fn listStates()
List workflow states for a team and sync them as resources
fn listComments()
Fetch all comments on an issue as a single thread resource
fn createComment(body: string)
Post a markdown comment on an issue
ArgumentTypeDescription
bodystringComment body (Markdown)

Resources

issue(infinite)— A Linear issue with resolved relations
team(infinite)— A Linear team
project(infinite)— A Linear project
document(infinite)— A Linear document with Markdown content
projectExternalLink(infinite)— An external link in a Linear project's Resources section
workflowState(infinite)— A Linear workflow state (e.g. Backlog, In Progress, Done)
viewer(infinite)— The authenticated Linear user
label(infinite)— A Linear issue label
commentThread(infinite)— The full comment thread on a Linear issue
issueDeletion(infinite)— Audit record for a verified Linear issue deletion
04Previous Versions10
2026.08.21.1

Add fail-closed, idempotent Linear issue deletion with live identifier/team verification and immutable deletion evidence.

Modified 1 models

2026.08.19.2
2026.08.19.1
2026.07.24.2

Add createEpic: single-call parent + child sub-issue creation with partial-failure reporting

Modified 1 models

2026.07.24.1

createIssue gains parentId (sub-issue/epic hierarchy) and estimate support

2026.07.16.1

Rebuild against swamp CLI 20260716

2026.07.15.1

Modified 1 models

2026.06.27.1

Added 1, removed 1 models

2026.05.22.2

Add @hivemq/linear attribution in README and module JSDoc

2026.05.22.1

Initial release: 11 methods for Linear issue CRUD, viewer auto-assignment, label management, and team/project/state listing

05Stats
A
100 / 100
Downloads
158
Archive size
256.4 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
Repository
https://github.com/meagerfindings/swamp-linear
06Platforms