Find practical answers about Linear CLI installation, API keys, authentication, configuration, Git branches, pull requests and privacy.
Choose a topic
Open any question for a direct answer. Relevant guides are included when a topic needs step-by-step instructions.
Linear CLI is a command-line tool that lets developers work with Linear issues directly from a terminal. It can list issues, start work, connect issues to branches, show issue details and help prepare pull requests.
Its main benefit is reducing unnecessary switching between a code editor, terminal and browser while working on an issue.
Browse Linear CLI CommandsNo. LinearCli.com is an independent documentation and reference website. It is not affiliated with or endorsed by Linear or the developer of the Linear CLI software.
The website organizes installation steps, commands, workflows and troubleshooting information into beginner-friendly guides.
Linear CLI supports multiple installation methods, including Homebrew, JavaScript package managers, Deno and downloadable binaries.
Choose only the method that matches your operating system and project environment. After installation, run the version command to confirm that the executable is available.
linear --version
Yes. Linear CLI needs a personal Linear API key to access workspace information permitted for your account. Personal API keys require member access and are not available to guest accounts.
Enter the key only when prompted by the CLI in your own terminal. Do not paste it into public forms, screenshots or shared code.
linear auth login
No. LinearCli.com does not ask for, receive or store your Linear API key. The website provides documentation only.
Authentication happens locally between the CLI running on your device and the services it is configured to use.
Project configuration tells Linear CLI which workspace, team and version-control system should be used for that repository.
Run the configuration command from inside the project folder so the settings are associated with the correct repository.
linear config
In a Git repository, Linear CLI reads the issue
identifier from the current branch name, such
as eng-123-fix-login.
In a Jujutsu repository, it reads the
Linear-issue trailer from the
current or an ancestor commit description.
linear issue id
Running the start command connects the selected issue to your development work. In a Git workflow, it creates or switches to an issue branch. In Jujutsu, it adds the issue trailer used to detect the work context.
linear issue start ENG-123
Yes. The pull-request command uses the issue connected to your current work and prepares the title and body through GitHub CLI.
GitHub CLI must already be installed, authenticated and connected to the current repository.
linear issue pr
Yes. Linear CLI supports Git branch-based workflows and Jujutsu commit-trailer workflows. Select the correct version-control system during project configuration.
Compare IntegrationsLinear CLI includes an optional skill that can help compatible coding agents understand and use its commands.
The skill is optional. Linear CLI works normally without an AI agent, and LinearCli.com does not connect to the agent or your account.
The CLI may not be installed correctly, or its executable directory may not be available in your terminal’s PATH.
Close and reopen the terminal, then run the version command. If it still fails, repeat the installation method for your environment.
linear --version
Try a shorter search such as install, API key, Git or pull request.
Diagnose installation, authentication, configuration, issue detection and pull-request problems using verified commands.