linear-install-auth

安装和配置Linear SDK/CLI身份验证。用于设置新的Linear集成、配置API密钥或在项目中初始化Linear。通过“安装Linear”、“设置Linear”、“Linear身份验证”、“配置Linear API密钥”、“Linear SDK设置”等短语触发。

📖 中文导读:安装和配置Linear SDK/CLI身份验证。用于设置新的Linear集成、配置API密钥或在项目中初始化Linear。通过“安装Linear”、“设置Linear”、“Linear身份验证”、“配置Linear API密钥”、“Linear SDK设置”等短语触发。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: linear-install-auth description: | Install and configure Linear SDK/CLI authentication. Use when setting up a new Linear integration, configuring API keys, or initializing Linear in your project. Trigger with phrases like "install linear", "setup linear", "linear auth", "configure linear API key", "linear SDK setup". allowed-tools: Read, Write, Edit, Bash(npm:), Bash(pnpm:), Bash(yarn:*), Grep version: 1.0.0 license: MIT author: Jeremy Longshore jeremy@intentsolutions.io

Linear Install & Auth

Overview

Set up Linear SDK and configure authentication credentials for API access.

Prerequisites

  • Node.js 18+ (Linear SDK is TypeScript/JavaScript only)
  • Package manager (npm, pnpm, or yarn)
  • Linear account with API access
  • Personal API key or OAuth app from Linear settings

Instructions

Step 1: Install SDK

# npm
npm install @linear/sdk

# pnpm
pnpm add @linear/sdk

# yarn
yarn add @linear/sdk

Step 2: Generate API Key

  1. Go to Linear Settings > API > Personal API keys
  2. Click "Create key"
  3. Copy the generated key (shown only once)

Step 3: Configure Authentication

# Set environment variable
export LINEAR_API_KEY="lin_api_xxxxxxxxxxxx"

# Or create .env file
echo 'LINEAR_API_KEY=lin_api_xxxxxxxxxxxx' >> .env

Step 4: Verify Connection

import { LinearClient } from "@linear/sdk";

const client = new LinearClient({ apiKey: process.env.LINEAR_API_KEY });
const me = await client.viewer;
console.log(`Authenticated as: ${me.name} (${me.email})`);

Output

  • Installed @linear/sdk package in node_modules
  • Environment variable or .env file with API key
  • Successful connection verification output

Error Handling

Error Cause Solution
Authentication failed Invalid or expired API key Generate new key in Linear settings
Invalid API key format Key doesn't start with lin_api_ Verify key format from Linear
Rate limited Too many requests Implement exponential backoff
Module not found Installation failed Run npm install @linear/sdk again
Network error Firewall blocking Ensure outbound HTTPS to api.linear.app

Examples

TypeScript Setup

import { LinearClient } from "@linear/sdk";

const linearClient = new LinearClient({
  apiKey: process.env.LINEAR_API_KEY,
});

// Verify connection
async function verifyConnection() {
  try {
    const viewer = await linearClient.viewer;
    console.log(`Connected as ${viewer.name}`);
    return true;
  } catch (error) {
    console.error("Linear connection failed:", error);
    return false;
  }
}

OAuth Setup (for user-facing apps)

import { LinearClient } from "@linear/sdk";

// OAuth tokens from your OAuth flow
const client = new LinearClient({
  accessToken: userAccessToken,
});

Resources

Next Steps

After successful auth, proceed to linear-hello-world for your first API call.