Skip to main content
← back to extensions

Linear

@mgreten/linearv2026.08.21.1· 1d 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, and team/project/state listing via the official @linear/sdk.

02Release Notes

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

03Models1
@mgreten/linearv2026.08.21.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 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
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 Versions9
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
118
Archive size
252.3 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