← 返回 Skills 市场
Linearis
作者
whoisnnamdi
· GitHub ↗
· v1.0.0
2630
总下载
4
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install linearis
功能描述
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.
使用说明 (SKILL.md)
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 \x3Ctoken>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 \x3Cdoc-id>
linearis documents update \x3Cdoc-id> --content "Updated"
linearis documents delete \x3Cdoc-id>
File Uploads/Downloads
linearis embeds upload ./screenshot.png
linearis embeds download "\x3Curl>" --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
安全使用建议
This skill is coherent with its stated purpose: it wraps the 'linearis' CLI and requires a Linear personal API key. Before installing: (1) Be prepared to provide a Linear API key — SKILL.md suggests storing it in ~/.linear_api_token, exporting LINEAR_API_TOKEN, or passing --api-token; prefer the method that fits your security posture and set tight file permissions if you write the token file. (2) The registry metadata did not declare the LINEAR_API_TOKEN requirement — treat that as a minor metadata omission and verify you supply the token securely. (3) The install uses npm; review the 'linearis' package source (linked docs/ GitHub) or install in a sandbox/container if you want to limit risk from third-party npm packages. (4) Expect that any data sent/received by the CLI goes to Linear.app (normal for this tool).
功能分析
Type: OpenClaw Skill
Name: linearis
Version: 1.0.0
The skill bundle is benign. It provides a standard CLI for Linear.app, requiring an API token and allowing file uploads/downloads, which are legitimate functionalities for an issue tracker. The installation method uses `npm install -g linearis`, a standard package manager command. There is no evidence of prompt injection, data exfiltration instructions, or other malicious intent within the `SKILL.md` or `_meta.json` files. The capabilities, while involving file system and network access, are aligned with the stated purpose of the skill.
能力评估
Purpose & Capability
Name/description match the actual behavior: the skill expects the 'linearis' CLI and documents commands for listing/creating/updating Linear issues, comments, documents, cycles, and projects. Requiring the 'linearis' binary (provided by the npm package) is appropriate for the stated purpose.
Instruction Scope
SKILL.md stays within scope (CLI usage examples and JSON output handling). It documents authentication methods and recommends storing a Linear personal API key in ~/.linear_api_token or using LINEAR_API_TOKEN/--api-token; that is expected for a CLI that talks to Linear, but the manifest did not declare this env requirement. The instructions also include upload/download commands which legitimately allow transferring files to/from Linear.
Install Mechanism
Install is an npm package ('linearis'), which is a reasonable, expected distribution channel for a Node-based CLI. This is moderate-risk in general (npm packages should be reviewed), but it is proportionate and expected for this skill.
Credentials
The skill manifest lists no required environment variables, yet SKILL.md documents three auth methods (file at ~/.linear_api_token, LINEAR_API_TOKEN env var, or --api-token). Requesting a Linear personal API key is appropriate, but the registry metadata should declare this (e.g., requires.env: LINEAR_API_TOKEN or primary credential).
Persistence & Privilege
The skill does not request always: true, does not declare system-level config paths beyond the optional ~/.linear_api_token, and is user-invocable. It does not ask to modify other skills or agent-wide settings.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install linearis - 安装完成后，直接呼叫该 Skill 的名称或使用
/linearis触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release of linearis 1.0.0:
- Provides a CLI for Linear.app issue tracking with JSON output, ideal for automation and scripting.
- Supports listing, creating, updating, and searching issues, comments, documents, cycles, and projects.
- Includes commands for teams, users, file uploads/downloads, and priority management.
- Authenticates via environment variable, file, or CLI token flag.
- All output is structured as JSON for easy integration with tools like jq.
元数据
常见问题
Linearis 是什么？
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. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2630 次。
如何安装 Linearis？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install linearis」即可一键安装，无需额外配置。
Linearis 是免费的吗？
是的，Linearis 完全免费（开源免费），可自由下载、安装和使用。
Linearis 支持哪些平台？
Linearis 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Linearis？
由 whoisnnamdi（@whoisnnamdi）开发并维护，当前版本 v1.0.0。
推荐 Skills