steampipe-plugin-linear

Linear Plugin for Steampipe

Use SQL to query issues, teams, users and more from Linear.

• Get started →
• Documentation: Table definitions & examples
• Community: Join #steampipe on Slack →
• Get involved: Issues

Quick start

Install

Download and install the latest Linear plugin:

steampipe plugin install linear

Configure your credentials and config file.

Configure your account details in ~/.steampipe/config/linear.spc:

connection "linear" {
  plugin = "linear"

  # Authentication information
  token  = "lin_api_0aHa1iYv9WMTLrEAoSNWlG1RHPy4N5DuM4uILY"
}

Or through environment variables

export LINEAR_TOKEN=lin_api_0aHa1iYv9WMTLrEAoSNWlG1RHPy4N5DuM4uILY

Run steampipe:

steampipe query

List your Linear issues:

select
  title,
  created_at,
  branch_name,
  priority
from
  linear_issue;

+----------------------------------------------------------------+---------------------------+-------------------------------------------------------+----------+
| title                                                          | created_at                | branch_name                                           | priority |
+----------------------------------------------------------------+---------------------------+-------------------------------------------------------+----------+
| ProTip: Mouse over this issue & press [Space]                  | 2023-05-09T12:41:21+05:30 | sourav/tur-8-protip-mouse-over-this-issue-press-space | 4        |
| test linear                                                    | 2023-05-09T12:43:21+05:30 | sourav/tur-11-test-linear                             | 0        |
+----------------------------------------------------------------+---------------------------+-------------------------------------------------------+----------+

Developing

Prerequisites:

• Steampipe
• Golang

Clone:

git clone https://github.com/turbot/steampipe-plugin-linear.git
cd steampipe-plugin-linear

Build, which automatically installs the new version to your ~/.steampipe/plugins directory:

make

Configure the plugin:

cp config/* ~/.steampipe/config
vi ~/.steampipe/config/linear.spc

Try it!

steampipe query
> .inspect linear

Further reading:

• Writing plugins
• Writing your first table

Contributing

Please see the contribution guidelines and our code of conduct. All contributions are subject to the Apache 2.0 open source license.

help wanted issues:

• Steampipe
• Linear Plugin