Delegate to the globally available linear-worktree CLI. Do not reimplement worktree, Linear, prompt, screenshot, or cmux logic inline.
Reference Files
| File | Read When |
|---|---|
references/usage-modes.md |
Choosing one issue, many issues, or --print |
references/repo-detection.md |
The user is outside the target repo or using --repo |
references/drive-workspaces.md |
After multi-issue fan-out, when this session needs to inspect or drive spawned cmux workspaces |
references/troubleshooting.md |
The CLI is missing, repo detection fails, cmux is unavailable, or launch mode fails |
references/verification.md |
Validating install, safe behavior, and full parity |
references/evaluation-scenarios.md |
Evaluating future skill/CLI changes |
Workflow
Copy this checklist to track progress:
linear-worktree progress:
- [ ] Confirm global CLI is available
- [ ] Choose mode
- [ ] Run the CLI
- [ ] Verify result or drive spawned sessions
- Confirm install:
command -v linear-worktree linear-worktree --help - Choose mode:
- One issue:
linear-worktree ENG-423 - Many bare issue IDs:
linear-worktree ENG-423 ENG-424 - Safe prompt/worktree only:
linear-worktree --print ENG-423
- One issue:
- Run from the intended repo, or pass
--repo <path>. - In launch mode, the CLI creates the worktree, starts Claude with
--dangerously-skip-permissions, and runs Claude from the new worktree directory.
Local Global Install
If the command is missing, install from the canonical repo:
cd ~/Code/mblode/linear-worktree
npm install
npm run build
npm link
command -v linear-worktree
Gotchas
- Launch cwd matters. Claude must start from the new worktree, not the repo that spawned the command.
- Multiple IDs fan out. Two or more bare issue IDs create cmux workspaces instead of doing all work in the current shell.
- Use
--printfor safe validation. It creates the worktree and prints the prompt without opening Claude. - Repo comes from cwd or
--repo. Run from inside the target repo, or pass--repo <path>when outside it.
Related Skills
cmux/cmux-workspacefor driving spawned workspaces.handoffwhen the Linear issue needs a richer brief than its description.