linear-install-auth

@jeremylongshore/linear-install-auth

jeremylongshore

1,004

123 forks

Updated 1/18/2026

View on GitHub

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

Installation

$skills install @jeremylongshore/linear-install-auth

Claude Code

Cursor

Copilot

Codex

Antigravity

Details

Repositoryjeremylongshore/claude-code-plugins-plus-skills

Pathplugins/saas-packs/linear-pack/skills/linear-install-auth/SKILL.md

Branchmain

Scoped Name@jeremylongshore/linear-install-auth

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions

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

Go to Linear Settings > API > Personal API keys
Click "Create key"
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.

More by jeremylongshore

View all

oauth-callback-handler

1,004

Oauth Callback Handler - Auto-activating skill for API Integration. Triggers on: oauth callback handler, oauth callback handler Part of the API Integration skill category.

rabbitmq-queue-setup

1,004

Rabbitmq Queue Setup - Auto-activating skill for Backend Development. Triggers on: rabbitmq queue setup, rabbitmq queue setup Part of the Backend Development skill category.

model-evaluation-suite

1,004

evaluating-machine-learning-models: This skill allows Claude to evaluate machine learning models using a comprehensive suite of metrics. It should be used when the user requests model performance analysis, validation, or testing. Claude can use this skill to assess model accuracy, precision, recall, F1-score, and other relevant metrics. Trigger this skill when the user mentions "evaluate model", "model performance", "testing metrics", "validation results", or requests a comprehensive "model evaluation".

neural-network-builder

1,004

building-neural-networks: This skill allows Claude to construct and configure neural network architectures using the neural-network-builder plugin. It should be used when the user requests the creation of a new neural network, modification of an existing one, or assistance with defining the layers, parameters, and training process. The skill is triggered by requests involving terms like "build a neural network," "define network architecture," "configure layers," or specific mentions of neural network types (e.g., "CNN," "RNN," "transformer").