360 Secure SkillHub
360 安全技能中心

Linearis

linearis 是面向 Linear.app 的命令行工具，安装后以 JSON 输出列出、搜索、创建、更新问题和评论，管理文档、团队、用户、项目与周期，并支持附件上传下载；通过个人 API Key 认证，便于 LLM Agent 调用与 jq 后处理。

whoisnnamdi
whoisnnamdi
热度 91.15
最近更新 2026-05-11 15:50:48
分类：协作依赖：代码执行 / 第三方 API / 读写文件应用场景：任务管理 / API 集成 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add linearis
Metadata
name
linearis
version
1.0.0
description
Linear.app CLI for issue tracking. Use for listing, creating, updating, and searching Linear issues, comments, documents, cycles, and projects. Optimized for LLM agents with JSON output.
metadata
{"clawdbot":{"emoji":"📋","requires":{"bins":["linearis"]},"install":[{"id":"npm","kind":"node","package":"linearis","bins":["linearis"],"label":"Install linearis (npm)"}]}}

linearis

CLI for Linear.app with JSON output, designed for LLM agents.

Setup

npm install -g linearis

Auth (one of):

  • echo "lin_api_..." > ~/.linear_api_token (recommended)
  • export LINEAR_API_TOKEN="lin_api_..."
  • --api-token <token> flag

Get API key: Linear Settings → Security & Access → Personal API keys

Commands

Issues

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

Comments

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

Documents

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>

File Uploads/Downloads

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

Teams, Users, Projects

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

Full Usage

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

Output

All commands return JSON by default. Pipe to jq for processing:

linearis issues list -l 5 | jq '.[].identifier'

Priority Values

  • 0: No priority
  • 1: Urgent
  • 2: High
  • 3: Medium
  • 4: Low

Links