Practical issue workflow

Take a Linear issue from assignment to pull request

Follow one connected terminal workflow to choose assigned work, create its development branch, keep the issue context visible and prepare the pull request.

  1. 1 Find issue
  2. 2 Start work
  3. 3 View context
  4. 4 Create PR

Choose your work

Find an issue assigned to you

List your unstarted assigned issues and choose the item you want to begin.
linear issue mine

Expected: Your assigned unstarted issues appear in the terminal.

Begin development

Start the selected issue

Replace ENG-123 with the real issue identifier. Linear CLI starts the issue and creates or switches to its branch.
linear issue start ENG-123

Expected: The issue is started and its development branch is ready.

Keep context visible

Read the current issue in your terminal

Linear CLI detects the issue connected to the current branch and displays its details as terminal-friendly content.
linear issue view

Expected: The issue description and related context appear in the terminal.

Complete the workflow

Create the connected pull request

Use the current issue information to prepare a GitHub pull request with its title and body already connected.
linear issue pr

Expected: GitHub CLI creates the pull request using the issue context.

This final command requires GitHub CLI to be installed and authenticated on your computer.

How issue detection works

The current branch keeps the issue connected

Linear CLI determines the current issue differently for Git and Jujutsu repositories.
Git eng-123-build-homepage

The issue identifier is read from the current branch name.

Jujutsu Linear-issue: ENG-123

The issue identifier is read from the commit-description trailer.

Quick checks

If the current issue is not detected

  • Check the repository: Run the commands from the configured project directory.
  • Check the identifier: Confirm that the Git branch includes an issue ID such as ENG-123.
  • Check configuration: Run linear config again if the team is missing or incorrect.
Open troubleshooting guide

Explore the reference

Find commands for your next Linear task

Browse issue, project, team and workflow commands in one reference.
Browse all commands

LinearCli.com is an independent documentation reference. Commands run locally in your terminal; this website does not access your issues or repository.