ClawHub

Native Linear

v1.0.1

Query and manage Linear issues, projects, cycles, and teams via the Linear GraphQL API. Use when you need to list or create issues, check cycle status, manag...

⭐ 16· 563·0 current·0 all-time
by@codeninja23

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for codeninja23/native-linear.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "Native Linear" (codeninja23/native-linear) from ClawHub.
Skill page: https://clawhub.ai/codeninja23/native-linear
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Required env vars: LINEAR_API_KEY
Required binaries: python3
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install native-linear

ClawHub CLI

Package manager switcher

npx clawhub@latest install native-linear
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
medium confidence
✓
Purpose & Capability
Name/description match the actual behavior: the script is a Python CLI that queries and mutates Linear via https://api.linear.app/graphql. Required binary (python3) and required env var (LINEAR_API_KEY) are appropriate and proportionate.
✓
Instruction Scope
SKILL.md instructs running the included Python script and setting LINEAR_API_KEY. The runtime instructions only reference the Linear API endpoint and the skill's own script path; there are no instructions to read unrelated files or exfiltrate data to external endpoints.
✓
Install Mechanism
No install spec is present (instruction-only with an included script). The script uses only Python stdlib (urllib) and does not pull external packages or execute downloads during install.
✓
Credentials
Only LINEAR_API_KEY is required and declared as primaryEnv; this is exactly the credential needed to call the Linear API. There are no unrelated secrets or config paths requested.
✓
Persistence & Privilege
always is false and the skill does not request persistent system-wide changes. It does not modify other skills' config or request elevated privileges; autonomous invocation is allowed by platform default and is not by itself a concern here.
Assessment
The skill appears internally consistent: it is a simple Python client that sends your LINEAR_API_KEY to api.linear.app/graphql and nothing else. Before installing, confirm you trust the skill source (the registry metadata lists no homepage and source is unknown). Use a Linear API key with minimal scope, rotate/revoke the key if you stop using the skill, and consider reviewing the full scripts/linear_query.py file yourself (or run it in a sandbox) to verify there are no hidden network calls or local file accesses beyond what is shown.

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

Binspython3
EnvLINEAR_API_KEY
Primary envLINEAR_API_KEY
latestvk97cgwmay1sz9ty0nrztnqnwr581r314
563downloads
16stars
2versions
Updated 2mo ago
v1.0.1
MIT-0
@codeninja23
latest
Download

Linear

Interact with Linear directly via the Linear GraphQL API (api.linear.app/graphql).

Setup (one-time)

  1. Go to Linear → Settings → Account → Security & Access → API keys
  2. Create a new key
  3. Set environment variable: 
    LINEAR_API_KEY=lin_api_...

Usage

List your teams

python3 /mnt/skills/user/linear/scripts/linear_query.py teams

List issues assigned to you

python3 /mnt/skills/user/linear/scripts/linear_query.py my-issues
python3 /mnt/skills/user/linear/scripts/linear_query.py my-issues --state "In Progress"

List issues for a team

python3 /mnt/skills/user/linear/scripts/linear_query.py issues --team "Engineering"
python3 /mnt/skills/user/linear/scripts/linear_query.py issues --team "Engineering" --state "Todo" --limit 20

Get a specific issue

python3 /mnt/skills/user/linear/scripts/linear_query.py issue ENG-123

Search issues

python3 /mnt/skills/user/linear/scripts/linear_query.py search "authentication bug"

Create an issue

python3 /mnt/skills/user/linear/scripts/linear_query.py create --team "Engineering" --title "Fix login bug" --description "Users can't log in on Safari"
python3 /mnt/skills/user/linear/scripts/linear_query.py create --team "Engineering" --title "Add dark mode" --priority 2

Update an issue

python3 /mnt/skills/user/linear/scripts/linear_query.py update ENG-123 --state "Done"
python3 /mnt/skills/user/linear/scripts/linear_query.py update ENG-123 --priority 1 --title "New title"

List projects

python3 /mnt/skills/user/linear/scripts/linear_query.py projects
python3 /mnt/skills/user/linear/scripts/linear_query.py projects --team "Engineering"

List cycles (sprints)

python3 /mnt/skills/user/linear/scripts/linear_query.py cycles --team "Engineering"

List workflow states for a team

python3 /mnt/skills/user/linear/scripts/linear_query.py states --team "Engineering"

Priority levels

  • 0 = No priority
  • 1 = Urgent
  • 2 = High
  • 3 = Normal
  • 4 = Low

Comments

Loading comments...