---
name: linear-config
description: Configure linear-cli - auth (API key + OAuth), workspaces, diagnostics, setup wizard.
allowed-tools: Bash
---
# Configuration
```bash
# 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
| `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 |