This is a simplified CLI program to choose an issue from Linear, an SaaS issue tracker. It can significantly improve development workflows.
Run the below command in your command line to install this tool:
go install github.com/guillermo/linear@latestFollow these steps to get your Linear API:
- Visit Linear API settings.
- Save the key in an environment variable named
LINEAR_KEY.
Recommended: Use a software like direnv to manage your environment variables.
To view all issues for a particular team, replace "My Team" with your team's name and run:
linear --team "My Team"It will display a list of issues. On selecting an issue, you'll see a string key in this format:
ID "TITLE" ISSUE_BRANCH
This program becomes even more powerful with the --run parameter which executes another program by passing the selected issue as an argument.
Here's an example of a bash script that accepts these parameters:
#!/bin/bash
help="Usage: issue ID \"TITLE\" BRANCH"
ISSUE=${1:?$help}
TITLE=${2:?$help}
BRANCH=${3:?$help}
echo ISSUE: $ISSUE
echo TITLE: $TITLE
echo BRANCH: $BRANCHLaunching the program with the following command:
linear --team "My team" --run issue.shWill print:
ISSUE: MY-1
TITLE: My first issue
BRANCH: guillermo/my-first-issue