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
Summary
Braid currently only supports Jira (via
acliCLI) for issue tracking integration. Adding Linear support would expand coverage for teams that use Linear as their project management tool.Current State
acliCLI wrapper insrc/main/services/jira.tsJiraSection)Proposal
Add a Linear integration that provides equivalent functionality:
src/main/services/linear.tsservice mirroring the Jira service patternlinear:*handlers for CRUD operations on issuesJiraSectionKey Features
Notes
@linear/sdk)