linearis

用于Linear.app的命令行界面，输出为JSON格式，专为LLM智能体设计。

设置

npm install -g linearis

认证（任选其一）：

• echo "lin_api_..." > ~/.linear_api_token（推荐）
• export LINEAR_API_TOKEN="lin_api_..."
• --api-token <token>标志

获取API密钥：Linear 设置 → 安全与访问 → 个人API密钥

命令

问题

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

评论

linearis comments create ABC-123 --body "Fixed in PR #456"

文档

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>

文件上传/下载

linearis embeds upload ./screenshot.png
linearis embeds download "<url>" --output ./file.png

团队、用户、项目

linearis teams list
linearis users list --active
linearis projects list
linearis cycles list --team WHO --active

完整用法

linearis usage  # Complete command reference (~1k tokens)

输出

所有命令默认返回JSON。可通过管道传输至jq进行处理：

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