linear

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Linear CLI

Standalone CLI for the Linear issue tracker. Zero dependencies beyond Python 3.

一款独立的Linear问题追踪器CLI工具，除Python 3外无其他依赖。

Setup

配置

On first use, authenticate via browser OAuth (no API keys needed):

bash

linear auth

Opens the browser for Linear authorization. Uses MCP Dynamic Client Registration + PKCE — credentials are stored at

~/.config/linear/

with

permissions.

The CLI script is bundled at

scripts/linear

within this skill directory. Execute it directly or reference its absolute path.

首次使用时，通过浏览器OAuth认证（无需API密钥）：

bash

linear auth

将打开浏览器进行Linear授权。采用MCP动态客户端注册+PKCE机制——凭证存储在

~/.config/linear/

目录下，权限为

。

CLI脚本位于本技能目录的

scripts/linear

路径下。可直接执行或引用其绝对路径。

Commands

命令

Create an issue

创建任务

bash

linear create "Issue title" \
  --team GLE \
  --state Todo \
  --assignee me \
  --due today \
  --priority high \
  --description "Markdown description" \
  --label "Bug"

Priority:

urgent

high

medium

low

none

(or 0-4).

Due date:

YYYY-MM-DD

today

tomorrow

bash

linear create "Issue title" \
  --team GLE \
  --state Todo \
  --assignee me \
  --due today \
  --priority high \
  --description "Markdown description" \
  --label "Bug"

优先级选项：

urgent

、

high

、

medium

、

low

、

none

（或0-4）。

截止日期格式：

YYYY-MM-DD

、

today

、

tomorrow

。

List issues

列出任务

bash

linear list --mine --status "In Progress"
linear list --team GLE --status Todo --limit 10
linear list --priority high --json

bash

linear list --mine --status "In Progress"
linear list --team GLE --status Todo --limit 10
linear list --priority high --json

Show issue details

查看任务详情

bash

linear show GLE-123
linear show GLE-123 --json

bash

linear show GLE-123
linear show GLE-123 --json

Update an issue

更新任务

bash

linear update GLE-123 --state "In Progress"
linear update GLE-123 --priority urgent --due 2026-05-01
linear update GLE-123 --assignee me --title "New title"

bash

linear update GLE-123 --state "In Progress"
linear update GLE-123 --priority urgent --due 2026-05-01
linear update GLE-123 --assignee me --title "New title"

Add a comment

添加评论

bash

linear comment GLE-123 "This is done, merging now"

bash

linear comment GLE-123 "This is done, merging now"

Workspace info

工作区信息

bash

linear teams
linear me
linear statuses --team GLE
linear labels --team GLE

bash

linear teams
linear me
linear statuses --team GLE
linear labels --team GLE

Conventions

约定

Use team key (e.g.
```
GLE
```
), not full team name, in
```
--team
```
flags.
Default assignee:
```
me
```
unless specified otherwise.
Default state for new issues:
```
Todo
```
.
Use
```
--due today
```
for same-day tasks.
The CLI outputs human-readable text by default; pass
```
--json
```
for machine-readable output.
When creating issues from conversation context, write a concise title and structured markdown description.

在
```
--team
```
参数中使用团队标识（例如
```
GLE
```
），而非完整团队名称。
默认经办人：未指定时为
```
me
```
（当前用户）。
新建任务的默认状态：
```
Todo
```
。
当日任务使用
```
--due today
```
参数。
CLI默认输出易读的文本格式；添加
```
--json
```
参数可获取机器可读的输出。
根据对话上下文创建任务时，需撰写简洁的标题和结构化的Markdown描述。