Lit - Manage your Linear tickets without ever leaving your Git workflow.

Perfect for the engineers who love building, but hate having to track everything.

Feels like you are just using git, but you are also keeping those Linear issues nice and tidy!

This CLI runs 100% locally, you just provide your Linear Key via env variable

Lit Checkout - Create Linear Issue and Git branch in one command

lit-checkout-trimmed.mov

Lit Switch - Search Linear Issues + switch to correct branch in one command

lit-switch-demo.mov

Features

In this version 0.1, only two commands are supported

1. A command to switch branches via description of the Linear Issue.

lit switch "description of issue"

• Runs a search through Linear for issues matching the description
• If multiple hits, will ask to disambiguate
• Assigns issue to you, marks as in progress
• git checkout the branch name (creaets it if it doesn't exist)

2. A command to commit changes and leave a comment on the ticket.

lit commit "commit message/issue comment"

• Figures out correct issue based on branch
• leaves a comment on the issue
• git commit -m

3. A command to create a new Issue and branch at the same time.

lit checkout "Issue Title" -d "Description of Issue" -t f

• Parses arguments: title, description (optional), issye type [bug, feature, improvement] (optional)
• Creates new Linear Issue
• Generates the Linear automation friendly branch name (exactly how Linear does it in the UI)
• Does git checkout -b LinearbranchName

Getting Started

Install

After cloning the repo, build and link with:

npm run install-global

API Keys

You'll need just one API key:

Linear API Key:

1. Go to Linear Settings > Security/Access
2. Create a personal API key
3. Set environment variable: export LINEAR_API_KEY=<your_key>

Alternatively, add to a .env file in the project root and the CLI will load them automatically.

That's it. You're ready to use lit!