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".
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.
| name | linear-install-auth |
|---|---|
| description | | |
| 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/sdkpackage 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.