Linear

Plugin Active

Managing Linear issues, projects, and teams for issue tracking, status updates, querying projects, and managing team workflows.

Purpose

To empower users to efficiently manage all aspects of their Linear workflow, from issue tracking to project status updates and team coordination, directly from Claude Code.

Features

Comprehensive Linear issue and project management
SDK automation and GraphQL API access
Bulk synchronization of code changes with Linear
Image upload and management
Automated configuration validation and setup checks

Use Cases

Creating and managing complex issue hierarchies (parent-child relationships)
Automating project status updates and reporting
Synchronizing development progress with issue tracking
Applying standardized labels for consistent categorization

Non-Goals

Managing issues outside of Linear
Replacing the Linear application entirely
Providing generic project management capabilities unrelated to Linear

Documentation

info:Configuration & parameter referenceWhile parameters and options are largely documented, the README implies an optional `lin` CLI integration and official Linear MCP server setup without explicitly detailing default configurations or precedence for these optional components.

Security

warning:Secret ManagementThe README and install instructions mention `LINEAR_API_KEY` and suggest adding it to the shell profile. The `hooks/post-edit.sh` script also references this key. While it suggests user configuration, it doesn't explicitly state it's handled via `userConfig` with `sensitive: true` as per security best practices.
warning:Keychain-stored secretsThe `LINEAR_API_KEY` is expected to be set as an environment variable. It is not explicitly handled via `userConfig` with `sensitive: true`, meaning it might be stored in plain text in settings.json.

Code Execution

warning:ValidationWhile the scripts are written in TypeScript and likely use basic validation, the presence of a bash script (`hooks/post-edit.sh`) that relies on `grep` and `jq` for parsing input, without explicit schema validation, poses a risk for malformed inputs.

Scope

info:Dry-run previewWhile the extension offers extensive Linear API interaction, there's no explicit `--dry-run` flag mentioned for state-changing operations like creating issues or projects.

Protocol

info:Idempotent retry & timeoutsThe Linear API itself likely handles idempotency and timeouts for its operations. The extension code does not explicitly detail custom retry logic or hard timeouts for its API calls.