linear-install-auth

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".

⭐939stars🔀114forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill automates the technical setup and authentication process for the Linear SDK. It streamlines developer workflows by handling package installation, environment variable configuration, and connection verification, ensuring a seamless integration between your codebase and Linear's project management platform.

Use Cases

  • Project Initialization: Rapidly set up the Linear SDK in new TypeScript or JavaScript projects using npm, pnpm, or yarn.
  • Secure API Configuration: Automate the creation and mapping of Linear Personal API keys to environment variables or .env files for secure access.
  • Connection Troubleshooting: Diagnose and fix common authentication hurdles like invalid key formats, expired tokens, or network-related API failures.
  • Integration Scaffolding: Generate boilerplate code for both Personal API and OAuth-based authentication flows to jumpstart custom tool development.
namelinear-install-auth
description|
allowed-toolsRead, Write, Edit, Bash(npm:*), Bash(pnpm:*), Bash(yarn:*), Grep
version1.0.0
licenseMIT
authorJeremy 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.