https://github.com/erickhun/lig
Linear Issue Gitflow
https://github.com/erickhun/lig
fzf gitflow linear
Last synced: 6 months ago
JSON representation
Linear Issue Gitflow
- Host: GitHub
- URL: https://github.com/erickhun/lig
- Owner: erickhun
- License: apache-2.0
- Created: 2025-03-24T07:03:03.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-03-25T11:04:04.000Z (11 months ago)
- Last Synced: 2025-04-07T01:59:23.310Z (11 months ago)
- Topics: fzf, gitflow, linear
- Language: Shell
- Homepage:
- Size: 3.76 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://github.com/junegunn/fzf) -> `brew install fzf` (cli fuzzy finder])
- [jq](https://jqlang.org/) -> `brew install jq` (cli json tool)
- [Linear](https://linear.app/) API key (Settings-> Security & Access -> Personal API Keys)
## Installation
0. Get your [Linear](https://linear.app/) API key (Settings-> Security & Access -> Personal API Keys))
1. `git clone git@github.com:erickhun/lig.git`
2. Source the script in your shell configuration (`.bashrc` or `.zshrc`):
```bash
export LINEAR_KEY="your_api_key"
source /path/to/lig.sh
```
## Usage
### `lig-branch`
Create a new Git branch from a Linear issue.
```bash
# 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.
```bash
# Open issue by ID
lig-view ABC-123
# Open issue from current branch name
lig-view
```
### Update the status of a Linear issue.
```bash
# 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