Skip to content

feat: Add Linear integration alongside Jira #26

@gedeagas

Description

@gedeagas

Summary

Braid currently only supports Jira (via acli CLI) for issue tracking integration. Adding Linear support would expand coverage for teams that use Linear as their project management tool.

Current State

  • Jira integration exists via acli CLI wrapper in src/main/services/jira.ts
  • Jira sections are rendered in the right panel (JiraSection)
  • IPC channels are wired for Jira operations

Proposal

Add a Linear integration that provides equivalent functionality:

  • CLI tool: Use the Linear CLI or Linear's GraphQL API directly
  • Service layer: New src/main/services/linear.ts service mirroring the Jira service pattern
  • IPC channels: linear:* handlers for CRUD operations on issues
  • UI: Linear section in the right panel, similar to JiraSection
  • Settings: Configuration page for Linear API key/workspace, option to choose between Jira and Linear (or both)

Key Features

  • View and link Linear issues to worktrees/sessions
  • Create issues from Braid
  • Update issue status (e.g., move to "In Progress" when a session starts)
  • Display issue details in the right panel

Notes

  • Linear has a well-documented GraphQL API and an official SDK (@linear/sdk)
  • Using the SDK directly may be simpler than wrapping a CLI tool
  • Should support team/workspace selection during setup

Metadata

Metadata

Assignees

Labels

No labels
No labels

Projects

Status
In progress

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions