initial commit

Author: pvik

.github/workflows/go.yml

@@ -0,0 +1,84 @@
+name: Go
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+  release:
+    types: [published]
+
+jobs:
+
+  build-release:
+    name: Build release Executable (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-musl
+          - os: ubuntu-latest
+            target: armv7-unknown-linux-musleabihf
+          - os: ubuntu-latest
+            target: aarch64-unknown-linux-musl
+          - os: macos-latest
+            target: x86_64-apple-darwin
+          - os: macos-latest
+            target: aarch64-apple-darwin
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+    env:
+      BINARY_EXTENSION: ${{ endsWith(matrix.target, '-msvc') && '.exe' || '' }}
+      PATH_BINARY: ${{ github.workspace }}/target/${{ matrix.TARGET }}/release/lin${{ matrix.EXTENSION }}${{ endsWith(matrix.target, '-msvc') && '.exe' || '' }}
+    steps:
+      - uses: actions/checkout@v4
+        
+      - name: Install deps for linux build
+        if: ${{ matrix.os == 'ubuntu-latest' }}
+        uses: awalsh128/cache-apt-pkgs-action@latest
+        with:
+          packages: gcc libgl1-mesa-dev xorg-dev
+          version: 1.0
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.25.4'
+
+      - name: Build
+        run: |
+          go build -v -o ${{ env.PATH_BINARY }} ./cmd/...
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.target }}-lin${{ env.BINARY_EXTENSION }}
+          path: ${{ env.PATH_BINARY }}
+          
+      - name: Evaluate shasum
+        run: echo -n $(shasum -ba 256 ${{ env.PATH_BINARY }} | cut -d " " -f 1) > ${{ env.PATH_BINARY }}.sha256
+        
+      - uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.target }}-lin.sha256
+          path: ${{ env.PATH_BINARY }}.sha256
+
+      - name: '[Optional] Publish Artifact'
+        if: ${{ github.event_name == 'release' }}
+        uses: svenstaro/upload-release-action@v2
+        with:
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          file: ${{ env.PATH_BINARY }}
+          asset_name: ${{ matrix.target }}-lin${{ env.BINARY_EXTENSION }}
+          tag: ${{ github.ref }}
+          overwrite: true
+          
+      - name: '[Optional] Publish Artifact (shasum)'
+        if: ${{ github.event_name == 'release' }}
+        uses: svenstaro/upload-release-action@v2
+        with:
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          file: ${{ env.PATH_BINARY }}.sha256
+          asset_name: ${{ matrix.target }}-lin${{ env.BINARY_EXTENSION }}.sha256
+          tag: ${{ github.ref }}
+          overwrite: true

.gitignore

@@ -0,0 +1,6 @@
+.env
+bin/
+log/
+*.log
+.#*
+.linear-cli-config.toml 

LICENSE.md

@@ -0,0 +1,42 @@
+PKGS := $(shell go list ./cmd/...)
+PKG_LIST := $(shell go list ./... | grep -v /vendor/)
+GO_FILES := $(shell find . -name '*.go' | grep -v /vendor/ | grep -v _test.go)
+
+export GO111MODULE=on
+#export GOOS=linux
+#export GOARCH=amd64
+
+.PHONY: all dep build clean test coverage coverhtml lint
+
+all: build
+
+lint: ## Lint the files
+	golint -set_exit_status ${PKG_LIST}
+
+test: ## Run unittests
+	go test -short ${PKG_LIST}
+
+race: dep ## Run data race detector
+	go test -race -short ${PKG_LIST}
+
+msan: dep ## Run memory sanitizer
+	go test -msan -short ${PKG_LIST}
+
+coverage: ## Generate global code coverage report
+	./tools/coverage.sh;
+
+coverhtml: ## Generate global code coverage report in HTML
+	./tools/coverage.sh html;
+
+dep: ## Get the dependencies
+	go mod download
+
+build: dep ## Build the binary file
+	mkdir -p bin
+	go build -v -o ./bin/ $(PKGS)
+
+clean: ## Remove previous build
+	find .bin/ -maxdepth 1 -type f -executable -exec rm {} +
+
+help: ## Display this help screen
+	@grep -h -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'

Makefile

@@ -0,0 +1,195 @@
+# Linear CLI 
+
+A CLI client to linear.app 
+
+This is primarily aimed at allowing a dev to interact with their issues from a CLI. 
+The goal is to improve adoption of Linear.app by devs who have a heavy terminal-focused workflow. 
+
+This allows for devs to quickly create issues for new tasks they may be starting work on, and also automatically create a new local git branch for the linear issue (and switch into it).
+This also provides an easy way to switch to git branch for a linear issue.
+
+## Usage 
+
+### Configuration
+
+XDG Config location is honored. In Linux/Mac this should be `~/.config/linear-cli/config.toml` 
+
+This file holds your Linear.app API Key. 
+You can create a Personal API Key in Settings > Security & access
+
+```toml
+LINEAR_API_KEY = "<key>"
+```
+
+#### Project Level Settings 
+
+You can set project level settings in your project directory by creating a `.linear-cli-config.toml`. 
+
+A Sample of this looks like: 
+
+```toml
+default_git_head_branch = "main"
+default_team = "Engineering"
+
+[default_issue_template]
+team = "Engineering"
+priority = 3
+status = "Todo"
+labels = ["Backend Team"]
+```
+
+#### List 
+
+- Issues 
+- Teams 
+- Projects 
+
+```
+NAME:
+   lin list - list entities
+
+USAGE:
+   lin list [command [command options]]
+
+COMMANDS:
+   issue, i, is  list issues
+   team, tm      list teams
+   project, prj  list projects
+
+OPTIONS:
+   --limit int  (default: 50)
+   --help, -h   show help
+```
+
+##### Examples: 
+
+- To list all you issues under a given team: (all of below are equivalent)
+```
+lin list issues --team="Engineering" --mine
+```
+
+```
+lin ls is --tm="Engineering" --mine
+```
+
+```
+lin l is --tm="Engineering" --mine
+```
+
+
+#### Details 
+
+- Issue 
+
+```
+NAME:
+   lin detail - show entity detail
+
+USAGE:
+   lin detail [command [command options]]
+
+COMMANDS:
+   issue, i, is  issue details
+
+OPTIONS:
+   --help, -h  show help
+```
+
+##### Examples:
+
+- To get details of a specific issue: (all of below are equivalent)
+
+```
+lin detail issue --id=ENG-9999
+```
+
+```
+lin cat issue --id=ENG-9999
+```
+
+```
+lin cat is --id=ENG-9999
+```
+
+```
+lin cat i --id=ENG-9999
+```
+
+
+
+#### Create 
+
+- Issue 
+
+Once an issue is created, linear-cli will try to open the issue in the default browser.
+
+(Note: You can  also set default values for fields like team, label, priority, status in the project level config file)
+
+```
+NAME:
+   lin new - create a new entity
+
+USAGE:
+   lin new [command [command options]]
+
+COMMANDS:
+   issue, i, is  issue details
+
+OPTIONS:
+   --help, -h  show help
+```
+
+##### Examples: 
+
+- Create a new issue ; create a new git-branch for issue and switch to it: (all below are equivalent)
+
+```
+lin new issue --team="Engineering" --title="test issue" --label="Backend Team" --label="Improvement" --priority=3 --status="Todo" --git-create-branch 
+```
+
+```
+lin touch is --tm="Engineering" --title="test issue" --label="Backend Team" --label="Improvement" --priority=3 --status="Todo" --g-cb
+```
+
+```
+lin mk is --tm="Engineering" --title="test issue" --label="Backend Team" --label="Improvement" --priority=3 --status="Todo" --g-cb
+```
+
+```
+lin mk i --tm="Engineering" --title="test issue" --label="Backend Team" --label="Improvement" --priority=3 --status="Todo" --g-cb
+```
+
+
+### Git 
+
+```
+NAME:
+   lin git - Linear based helper commands for git repo
+
+USAGE:
+   lin git [command [command options]]
+
+COMMANDS:
+   switch, sw  checkout to the branch for linear issue (if it already exists)
+
+OPTIONS:
+   --help, -h  show help
+```
+
+##### Examples 
+
+- Switch branch for linear issue ; Create branch if it doesn't exist: (all below are equivalent)
+
+```
+lin git switch --id=ENG-9999 --create-if-not-exists
+```
+
+```
+lin g sw --id=ENG-9999 --cr
+```
+
+
+## TODO 
+
+- [ ] Cache Teams and Issue Labels locally 
+- [ ] Show timestamps in local timezone