linear-config

name	linear-config
description	Configure linear-cli - auth (API key + OAuth), workspaces, diagnostics, setup wizard.
allowed-tools	Bash

Configuration

# First-time setup wizard
linear-cli setup

# Set API key
linear-cli config set-key YOUR_API_KEY

# Show config
linear-cli config show

# Auth commands
linear-cli auth login                # Store API key
linear-cli auth oauth                # OAuth 2.0 browser flow (PKCE)
linear-cli auth oauth --client-id ID # Custom OAuth app
linear-cli auth status               # Check auth status (shows type, expiry)
linear-cli auth revoke               # Revoke OAuth tokens
linear-cli auth logout               # Remove key

# Workspaces
linear-cli config workspace-add work KEY
linear-cli config workspace-list
linear-cli config workspace-switch work
linear-cli config workspace-current

# Profiles
linear-cli --profile work i list     # Use profile

# Diagnostics
linear-cli doctor                    # Check config and connectivity
linear-cli doctor --fix              # Auto-fix common issues

# Shell completions (static)
linear-cli config completions bash > ~/.bash_completion.d/linear-cli

# Shell completions (dynamic, context-aware)
linear-cli completions dynamic bash >> ~/.bashrc
linear-cli completions dynamic zsh >> ~/.zshrc
linear-cli completions dynamic fish >> ~/.config/fish/completions/linear-cli.fish

Environment Variables

Variable	Purpose
LINEAR_API_KEY	API key override
LINEAR_CLI_PROFILE	Profile override
LINEAR_CLI_OUTPUT	Default output format
LINEAR_CLI_YES	Auto-confirm prompts
LINEAR_CLI_NO_PAGER	Disable pager