Linear CLI integrations

Keep your issue connected from branch to pull request.

Use Linear CLI with Git, Jujutsu, GitHub CLI and supported AI-agent workflows. Each integration below explains what is required, which command to run and what result you should expect.

Start with Git Check Configuration

Choose your workflow

Practical setup

Select the integration that matches your tools

You do not need every integration. Follow only the section that matches the version-control and development tools already used in your project.

Version control

Connect a Linear issue to a Git branch

Requires a Git repository

How the connection works

Linear CLI detects the current issue from its ID in your Git branch name. Starting an issue creates or switches to a branch containing that identifier.

Example branch eng-123-fix-login

Use this when: your project follows a normal Git branch workflow.

Start the issue Creates or switches branch
linear issue start ENG-123
Verify the current issue Reads the branch issue ID
linear issue view

Expected result: the terminal displays the Linear issue linked to your current branch.

Version control

Connect an issue through a Jujutsu trailer

Requires a Jujutsu repository

How the connection works

In a Jujutsu repository, Linear CLI identifies the issue from a Linear-issue trailer in the current or an ancestor commit description.

Expected trailer Linear-issue: ENG-123

Use this when: your project uses Jujutsu instead of Git branches.

Start and connect the issue Adds the issue trailer
linear issue start ENG-123
Add the trailer manually Alternative method
jj describe "$(linear issue describe ENG-123)"

Expected result: Linear CLI detects the issue from the commit description without relying on a branch name.

Pull requests

Create a GitHub pull request from the issue

Requires authenticated GitHub CLI

How the connection works

Linear CLI uses the issue connected to your current work and passes its details to GitHub CLI when preparing the pull request.

Information prepared Issue title + description

Before running: confirm that gh is installed and authenticated for the current repository.

Confirm GitHub CLI access Checks authentication
gh auth status
Create the pull request Uses the current issue
linear issue pr

Expected result: GitHub CLI opens the pull-request flow with the issue title and body already prepared.

Optional workflow

Make Linear CLI commands available to an AI agent

Optional

What the skill provides

The optional Linear CLI skill gives compatible coding agents command guidance for working with issues, statuses and other Linear CLI tasks.

Important Your agent runs the CLI locally

Privacy note: LinearCli.com does not receive the commands, credentials or workspace information.

Add the optional CLI skill For compatible agents
npx skills add schpet/linear-cli

This integration is not required. Linear CLI can be used normally without installing an agent skill.

Quick decision

Which integration matches your workflow?

Start with one route. Additional integrations can be added later without changing your existing Linear CLI setup.

Git Branch-based development linear issue start ENG-123 View setup
Jujutsu Commit-trailer workflow Linear-issue: ENG-123 View setup
GitHub CLI Pull-request creation linear issue pr View setup
AI agents Optional agent assistance npx skills add View setup
Something not connecting?

Check the issue, repository and authentication state.

Most integration problems come from a missing issue ID, incorrect repository configuration or an unauthenticated command-line tool.

Open Troubleshooting Browse Commands