pi-linear

Pi extension for Linear issue tracking — search, create, update issues, manage teams, and track work from your terminal.

Package details

extension

Install pi-linear from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-linear
Package
pi-linear
Version
0.2.0
Published
Apr 24, 2026
Downloads
227/mo · 227/wk
Author
lucianojr
License
MIT
Types
extension
Size
17.8 KB
Dependencies
1 dependency · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-linear

Pi extension for Linear issue tracking. Search, create, update issues, manage teams, and track work — all from your terminal.

Install

pi install npm:pi-linear

Setup

  1. Get a Linear API key from Linear Settings → API
  2. Set it as an environment variable:
export LINEAR_API_KEY="lin_api_..."

Add to your ~/.zshrc or ~/.bashrc to persist.

Tools

The extension registers 9 tools the LLM can call:

Tool Description
linear_search Search issues by text query
linear_get_issue Get full issue details by ID (e.g., ENG-123)
linear_create_issue Create a new issue
linear_update_issue Update issue (title, status, assignee, priority)
linear_list_teams List all teams (get team IDs)
linear_list_states List workflow states for a team
linear_list_users List workspace users (for assignment)
linear_my_issues List issues assigned to me
linear_add_comment Add a comment to an issue

Commands

Command Description
/linear Check connection status

Usage

After installing and setting LINEAR_API_KEY, just ask:

  • "Show my Linear issues"
  • "Search Linear for notification service"
  • "Create a Linear issue for the auth bug"
  • "Update ENG-123 to In Progress"
  • "List all teams in Linear"

License

MIT