skills/linear-config/SKILL.md
Configure linear-cli - auth (API key + OAuth), workspaces, diagnostics, setup wizard.
npx skillsauth add finesssee/linear-cli linear-configInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
# 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
| 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 |
tools
Start/stop work on Linear issues. Use when beginning work, creating branches, or getting current issue context.
development
Manage webhooks - create, listen for events, rotate secrets. Use when setting up integrations or event listeners.
tools
Watch Linear issues for changes. Use for monitoring updates.
tools
Manage custom views - create, list, apply saved views. Use when working with saved issue filters.