Back to Details

linear

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Linear

Linear

Manage issues, cycles, labels, documents, attachments, and projects via the official 
@linear/sdk
.
Default team: DOMA (set via 
LINEAR_DEFAULT_TEAM
env var).
通过官方
@linear/sdk
管理工单、周期、标签、文档、附件和项目。
默认团队：DOMA（通过
LINEAR_DEFAULT_TEAM
环境变量设置）。

Run

运行

bash
bun {baseDir}/scripts/linear.ts <command> [args]
bash
bun {baseDir}/scripts/linear.ts <command> [args]

Issues

工单

bash
undefined
bash
undefined

Browse

浏览

bun {baseDir}/scripts/linear.ts my-issues bun {baseDir}/scripts/linear.ts team [TEAM_KEY] bun {baseDir}/scripts/linear.ts issue DOMA-123 bun {baseDir}/scripts/linear.ts search "auth bug"
bun {baseDir}/scripts/linear.ts my-issues bun {baseDir}/scripts/linear.ts team [TEAM_KEY] bun {baseDir}/scripts/linear.ts issue DOMA-123 bun {baseDir}/scripts/linear.ts search "auth bug"

Create (supports flags for priority, status, assignee, label, due date)

创建（支持优先级、状态、经办人、标签、截止日期等参数）

bun {baseDir}/scripts/linear.ts create "Title" "Description" bun {baseDir}/scripts/linear.ts create "Title" "Description" --priority high --status todo --assignee Sam --label Bug --due 2026-04-01
bun {baseDir}/scripts/linear.ts create "Title" "Description" bun {baseDir}/scripts/linear.ts create "Title" "Description" --priority high --status todo --assignee Sam --label Bug --due 2026-04-01

Update (all fields via flags)

更新（所有字段可通过参数设置）

bun {baseDir}/scripts/linear.ts update DOMA-123 --title "New title" --description "Full desc" --priority high --status progress --assignee Sam --label Feature --due 2026-04-01
bun {baseDir}/scripts/linear.ts update DOMA-123 --title "New title" --description "Full desc" --priority high --status progress --assignee Sam --label Feature --due 2026-04-01

Quick actions

快捷操作

bun {baseDir}/scripts/linear.ts comment DOMA-123 "Comment text" bun {baseDir}/scripts/linear.ts status DOMA-123 progress bun {baseDir}/scripts/linear.ts priority DOMA-123 high bun {baseDir}/scripts/linear.ts assign DOMA-123 Sam
bun {baseDir}/scripts/linear.ts comment DOMA-123 "Comment text" bun {baseDir}/scripts/linear.ts status DOMA-123 progress bun {baseDir}/scripts/linear.ts priority DOMA-123 high bun {baseDir}/scripts/linear.ts assign DOMA-123 Sam

Lifecycle

生命周期操作

bun {baseDir}/scripts/linear.ts archive DOMA-123 bun {baseDir}/scripts/linear.ts unarchive DOMA-123 bun {baseDir}/scripts/linear.ts delete DOMA-123
bun {baseDir}/scripts/linear.ts archive DOMA-123 bun {baseDir}/scripts/linear.ts unarchive DOMA-123 bun {baseDir}/scripts/linear.ts delete DOMA-123

Relations

关联关系

bun {baseDir}/scripts/linear.ts relate DOMA-123 DOMA-456 blocks bun {baseDir}/scripts/linear.ts relate DOMA-123 DOMA-456 relates-to bun {baseDir}/scripts/linear.ts relate DOMA-123 DOMA-456 duplicates
bun {baseDir}/scripts/linear.ts relate DOMA-123 DOMA-456 blocks bun {baseDir}/scripts/linear.ts relate DOMA-123 DOMA-456 relates-to bun {baseDir}/scripts/linear.ts relate DOMA-123 DOMA-456 duplicates

Batch create from JSON array or file path

批量创建（支持内联JSON字符串或文件路径）

bun {baseDir}/scripts/linear.ts batch-create '[{"title":"Issue 1","priority":"high"},{"title":"Issue 2","assignee":"Sam"}]' --team DOMA bun {baseDir}/scripts/linear.ts batch-create issues.json --team DOMA
undefined
bun {baseDir}/scripts/linear.ts batch-create '[{"title":"Issue 1","priority":"high"},{"title":"Issue 2","assignee":"Sam"}]' --team DOMA bun {baseDir}/scripts/linear.ts batch-create issues.json --team DOMA
undefined

Cycles

周期

bash
undefined
bash
undefined

List cycles for a team

列出团队的周期

bun {baseDir}/scripts/linear.ts cycles [TEAM_KEY]
bun {baseDir}/scripts/linear.ts cycles [TEAM_KEY]

Show current active cycle with all its issues

查看当前活跃周期及其所有工单

bun {baseDir}/scripts/linear.ts cycle-current [TEAM_KEY]
undefined
bun {baseDir}/scripts/linear.ts cycle-current [TEAM_KEY]
undefined

Labels

标签

bash
undefined
bash
undefined

List labels (workspace-wide or team-scoped)

列出标签（全局或指定团队）

bun {baseDir}/scripts/linear.ts labels bun {baseDir}/scripts/linear.ts labels DOMA
bun {baseDir}/scripts/linear.ts labels bun {baseDir}/scripts/linear.ts labels DOMA

Create a label

创建标签

bun {baseDir}/scripts/linear.ts label-create "Bug" --color "#ff0000" --description "Software defect" --team DOMA
undefined
bun {baseDir}/scripts/linear.ts label-create "Bug" --color "#ff0000" --description "Software defect" --team DOMA
undefined

Documents

文档

bash
undefined
bash
undefined

List documents

列出文档

bun {baseDir}/scripts/linear.ts docs
bun {baseDir}/scripts/linear.ts docs

View a document (by UUID)

查看文档（通过UUID）

bun {baseDir}/scripts/linear.ts doc <DOC_ID>
bun {baseDir}/scripts/linear.ts doc <DOC_ID>

Create a document

创建文档

bun {baseDir}/scripts/linear.ts doc-create "Architecture Notes" --content "## Overview\n\nDetails here..." --project <PROJECT_ID>
undefined
bun {baseDir}/scripts/linear.ts doc-create "Architecture Notes" --content "## Overview\n\nDetails here..." --project <PROJECT_ID>
undefined

Attachments

附件

bash
undefined
bash
undefined

List attachments on an issue

列出工单的附件

bun {baseDir}/scripts/linear.ts attachments DOMA-123
bun {baseDir}/scripts/linear.ts attachments DOMA-123

Add an attachment

添加附件

bun {baseDir}/scripts/linear.ts attach DOMA-123 "Design mockup" "https://figma.com/..." --subtitle "Homepage redesign"
undefined
bun {baseDir}/scripts/linear.ts attach DOMA-123 "Design mockup" "https://figma.com/..." --subtitle "Homepage redesign"
undefined

Teams & Projects

团队与项目

bash
bun {baseDir}/scripts/linear.ts teams
bun {baseDir}/scripts/linear.ts projects [TEAM_KEY]
bun {baseDir}/scripts/linear.ts standup
bash
bun {baseDir}/scripts/linear.ts teams
bun {baseDir}/scripts/linear.ts projects [TEAM_KEY]
bun {baseDir}/scripts/linear.ts standup

Status values

状态值

todo
· 
progress
(In Progress) · 
in-progress
· 
review
(In Review) · 
in-review
· 
done
· 
blocked
· 
backlog
· 
cancelled
· 
canceled
todo
· 
progress
（进行中） · 
in-progress
· 
review
（审核中） · 
in-review
· 
done
· 
blocked
· 
backlog
· 
cancelled
· 
canceled

Priority values

优先级值

urgent
· 
high
· 
medium
· 
low
· 
none
urgent
· 
high
· 
medium
· 
low
· 
none

Relation types

关联类型

blocks
· 
relates-to
· 
duplicates
blocks
· 
relates-to
· 
duplicates

Notes

注意事项

  • issue
    detail view shows labels, relations, attachments, and comments
  • create
    and 
    update
    support 
    --priority
    , 
    --status
    , 
    --assignee
    , 
    --label
    , 
    --due
    flags
  • update
    supports multiple flags in one call
  • search
    does full-text search across all issues
  • batch-create
    accepts inline JSON string or a file path, with caching for user/label/state lookups
  • delete
    is permanent — use 
    archive
    for reversible removal
  • Documents use UUIDs, not team identifiers
  • issue
    详情视图会显示标签、关联关系、附件和评论
  • create
    和
    update
    支持
    --priority
    、
    --status
    、
    --assignee
    、
    --label
    、
    --due
    参数
  • update
    支持单次调用设置多个参数
  • search
    支持对所有工单进行全文搜索
  • batch-create
    接受内联JSON字符串或文件路径，会缓存用户/标签/状态的查询结果
  • delete
    为永久删除——如需可逆移除请使用
    archive
  • 文档使用UUID而非团队标识符