介绍
# linearis
[Linear.app](https://linear.app) 的命令行界面（CLI），支持 JSON 输出，专为 LLM 智能体设计。
## 设置
```bash npm install -g linearis ```
身份验证（任选其一）： - `echo "lin_api_..." > ~/.linear_api_token` （推荐） - `export LINEAR_API_TOKEN="lin_api_..."` - `--api-token <token>` 标志
获取 API 密钥：Linear 设置 → 安全与访问 → 个人 API 密钥
## 命令
### 问题 (Issues)
```bash linearis issues list -l 20 # List recent issues linearis issues list -l 10 --team WHO # Filter by team linearis issues search "bug" # Full-text search linearis issues read ABC-123 # Get issue details linearis issues create --title "Fix bug" --team WHO --priority 2 linearis issues update ABC-123 --status "Done" linearis issues update ABC-123 --title "New title" --assignee user123 linearis issues update ABC-123 --labels "Bug,Critical" --label-by adding linearis issues update ABC-123 --parent-ticket EPIC-100 # Set parent ```
### 评论
```bash linearis comments create ABC-123 --body "Fixed in PR #456" ```
### 文档
```bash linearis documents list linearis documents list --project "Backend" linearis documents create --title "Spec" --content "# Overview..." linearis documents read <doc-id> linearis documents update <doc-id> --content "Updated" linearis documents delete <doc-id> ```
### 文件上传/下载
```bash linearis embeds upload ./screenshot.png linearis embeds download "<url>" --output ./file.png ```
### 团队、用户、项目
```bash linearis teams list linearis users list --active linearis projects list linearis cycles list --team WHO --active ```
### 完整用法
```bash linearis usage # Complete command reference (~1k tokens) ```
## 输出
默认情况下，所有命令均返回 JSON。可以使用管道传输给 `jq` 进行处理：
```bash linearis issues list -l 5 | jq '.[].identifier' ```
## 优先级值
- 0: 无优先级 - 1: 紧急 - 2: 高 - 3: 中 - 4: 低
## 链接
- 文档: https://github.com/czottmann/linearis - 博客: https://zottmann.org/2025/09/03/linearis-my-linear-cli-built.html