Linear Issue GitFlow (lig)
lig integration between Linear (project management tool) and Git. Quickly create branches from issues assigned to you, view issues, and update issue statuses directly from the terminal.
Features
- 🌿 Branch Creation: Easily create Git branches from Linear issues
- 👀 Issue Viewing: Open Linear issues directly from the terminal
- 🔄 Status Updates: Update issue statuses with an interactive workflow
Prerequisites
- fzf ->
brew install fzf(cli fuzzy finder]) - jq ->
brew install jq(cli json tool) - Linear API key (Settings-> Security & Access -> Personal API Keys)
Installation
-
Get your Linear API key (Settings-> Security & Access -> Personal API Keys))
-
git clone git@github.com:erickhun/lig.git -
Source the script in your shell configuration (
.bashrcor.zshrc):export LINEAR_KEY="your_api_key" source /path/to/lig.sh
Usage
lig-branch
Create a new Git branch from a Linear issue.
# Fetch your assigned issues (limit to 50) lig-branch # Customize number of issues fetched lig-branch me 100 # Fetch all teams issues lig-branch all
Open a Linear issue in your default browser.
# Open issue by ID lig-view ABC-123 # Open issue from current branch name lig-view
Update the status of a Linear issue.
# Update status for a specific issue lig-status ABC-123 # Update status for current branch's issue lig-status
Improvements:
Add suport for other tracking system: g(it)ig, j(ira)ig, m(onday)ig, etc...
Diclaimer
This tool was create with the help of Claude
