linear-worktree
v0.2.1
Published
Create git worktrees for Linear issues and launch Claude sessions
Readme
linear-worktree
Create a git worktree for a Linear issue and open it in Claude.
Installation
npm i -g linear-worktreeUsage
From inside your repo, pass one or more Linear issue IDs:
linear-worktree ENG-403
linear-worktree ENG-403 ENG-404 ENG-405For each issue, the CLI creates a git worktree, opens it in a new
cmux workspace, and launches claude in plan mode from
that worktree. The full ticket (title, description, and screenshots) is dropped
in as the prompt. Pass several IDs to fan out one workspace per issue.
Linear API key
Set LINEAR_API_KEY to load issue details and screenshots into the prompt:
export LINEAR_API_KEY=lin_api_...Create a key in Linear's API settings.
Agent skill
This repo ships an agent skill that teaches your coding agent to run the CLI for you. Install it globally:
npx skills add mblode/linear-worktree -gRequirements
- Node.js >= 22
git,claude, andcmuxon your PATH
Works well with
Drive all the worktrees from one central Claude session using the
cmux skill: approve plans and run follow-up skills like
/simplify, /pr-reviewer, or /visual-qa across every workspace at once.
