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