linearcreate

Linear CLI Tool (lc)

lc (Linear Create and Open) is a command-line interface tool that simplifies the process of creating Linear issues and generating corresponding branch names. It integrates with the Linear API to create issues and provides options for opening the issue in the browser, copying a generated branch name to the clipboard, or creating a git branch with an initial commit.

Features

• Create Linear issues from the command line
• Generate branch names based on the created issue
• Open the created issue in the default web browser
• Copy the generated branch name to the clipboard
• Create a git branch and initial commit using the gt tool
• Specify team stub for issue creation
• Environment variable support for API key and default settings

Installation

• Clone this repository:

  git clone https://github.com/yourusername/lc.git
  cd lc
  

• Install dependencies:

  npm install
  

• Create a .env file in the project root and add the following environment variables:

  LINEAR_API_KEY=your_linear_api_key
  USER_ID=your_linear_user_id
  DEFAULT_TEAM_STUB=default_team_stub
  

• Build the project:

  npm run build
  

• Make the CLI tool globally accessible:

  npm link
  

Usage

lc [options]

Options

• -t, --teamstub <stub>: Specify the team stub (e.g., bknd, frtd). Defaults to the value in DEFAULT_TEAM_STUB.
• -o, --open: Open the created issue in Linear using the default web browser.
• -d, --description <text>: Add a description to the Linear issue.
• --help: Show help information.

Examples

• Create an issue and copy the branch name to clipboard:

  lc "Implement user authentication"
  

• Create an issue for a specific team and open it in the browser:

  lc "Fix pagination bug" -t bknd -o
  

• Create an issue with a description:

  lc "Add new API endpoint" -d "This endpoint will handle user profile updates"
  

• Create an issue, copy branch name and issue title to clipboard, and create a git branch with commit:

  lc "Refactor database queries" --gt
  

• Show help information:

  lc --help
  

Contributing

Contributions are welcme! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License.