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