joeynotjoe/Alfred_wf_Linear

Linear Workflow for Alfred

Create Linear issues from the Alfred UI
Explore the docs »

· Report Bug · Request Feature

Table of Contents

About The Project
- Built With
Getting Started
- Prerequisites
- Installation
Usage
Roadmap
Contributing
Contact
Acknowledgments

About The Project

Linear is a modern issue tracking and project management tool that helps software teams ship better products, faster. It provides a streamlined interface for tracking issues, managing projects, and collaborating with your team.

This Alfred Workflow is designed to make it easy to create new issues directly from Alfred (a productivity application for macOS) and send them to your Linear account. Instead of having to switch to the Linear web app or manually create issues, you can quickly capture and send issues as they come up, right from your desktop.

Here's a more detailed overview of what this workflow enables:

- Link Your Linear Account

The workflow allows you to authenticate and link your Linear account credentials. This connects Alfred to your Linear projects and workspaces.

- Create New Issues Quickly

With a simple keyword or hotkey, you can bring up the workflow and start creating a new issue. The workflow will prompt you for the issue title

- Send Issues Instantly

Once you've entered all the details, the workflow will instantly create the new issue in your linked Linear team. No more context switching or manual entry.

-Increased Productivity

By reducing the friction to create and track issues, this workflow aims to boost your productivity. You can capture issues and ideas as they occur, without losing focus or context on your current task.

The overall goal is to provide a seamless way to integrate Linear's powerful issue tracking capabilities into your existing workflow, leveraging Alfred's speed and accessibility. This can be particularly useful for developers, QA engineers, project managers, or anyone who needs to frequently create and manage issues or tasks within their software development lifecycle.

(back to top)

Built With

(back to top)

Getting Started

Install the Linear Issue Maker
- Download Linear Issue Maker.alfredworkflow from the repo (not yet accepted into Alfred gallery) and double click to install
- Alfred may prompt you to grant certain permissions or provide your system password to complete the installation.
Configure the Linear Issue Maker
- After installation, the Linear Issue Maker will be listed in the Workflows section of Alfred Preferences.
- Click on the Linear Issue Maker to view its configuration options.
- You will need to provide your personal API key and team UUID from Linear to authenticate and connect the workflow.
- Follow the instructions within the workflow to enter these credentials.
Start Using the Linear Issue Maker
- Once configured, you can invoke the Linear Issue Maker by typing the designated keyword (e.g., "linear issue") in Alfred's search bar.
- The workflow will provide actions and features related to creating new issues in Linear directly from Alfred.

Please note that providing your personal API key and team UUID is a required step to ensure the Linear Issue Maker can authenticate and interact with your Linear account and team correctly.

Installation

Download the Linear Issue Maker.alfredworkflow file from the repo and execute to install into Alfred
Once installed, you can configure the Linear Issue Maker workflow by:
- Right-clicking on the workflow name in Alfred's sidebar and selecting "Configure..."[2]
- Or clicking "Configure Workflow..." under the workflow's name in Alfred Preferences[2]
Follow any configuration prompts to set up required settings like your Linear API key, project, etc.[1][3]

The Linear Issue Maker workflow allows you to quickly create new issues in your Linear project from Alfred. By configuring it with your Linear account details, you can streamline your issue tracking workflow directly from Alfred's launcher.[1][3]

If you need any help configuring or using the Linear Issue Maker workflow, you can check the official Alfred Forum for support from the community.[2][4]

Citations:

[1] https://linear.app/docs/configuring-workflows

[2] https://www.alfredapp.com/workflows/

[3] https://linear.app

[4] https://www.alfredapp.com/blog/guides-and-tutorials/create-your-own-workflows/

(back to top)

Usage

This Alfred workflow allows you to quickly create linear issues from your desktop using a simple keyword and text input.

Invoke the workflow by typing the keyword li followed by a space.
Enter the title or description of the issue you want to create.
Press Enter to submit the input.

The workflow will automatically create a new linear issue with the provided title or description.

Examples

li Add support for dark mode - Creates a new issue titled "Add support for dark mode".
li Fix bug in login flow: Users are unable to reset their passwords - Creates a new issue with the detailed description.

You can also use the li keyword without any text to open the linear web app directly. (implemented in v1.1.0)

(back to top)

Roadmap

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!