linear-worktree

Linear Issue Worktree Setup

Set up a new git worktree for a Linear issue, creating a separate working directory off the main branch.

Usage

/linear-worktree <project-path> <linear-issue-id>

What this command does

1. Fetch Linear Issue: Retrieves issue details to get the suggested git branch name
2. Create Worktree: Creates a new git worktree in ../tracewell-<branch-name> directory
3. Switch Context: Changes to the new worktree directory
4. Ready for Work: Leaves you in the new worktree, ready to run /linear-implement

Arguments

• First argument: Path to the project directory (e.g., tracewell2)
• Second argument: The Linear issue ID (e.g., TRA-9, DEV-123)

Requirements

• Linear integration configured (MCP Linear tools available)
• Current working directory must be a git repository
• main branch exists and is up-to-date

Example

/linear-worktree tracewell2 TRA-9

This will:

1. Change to the tracewell2 directory
2. Fetch Linear issue TRA-9 details
3. Create a new worktree at ../tracewell-<branch-name>
4. Copy .env and config/master.key to the new worktree
5. Switch to the new worktree directory
6. Run bin/setup inside the new worktree
7. Ready for you to run /linear-implement TRA-9

Benefits of Using Worktrees

• Work on multiple features simultaneously without branch switching
• Keep your main working directory clean
• Avoid stashing changes when switching between issues
• Each worktree maintains its own file state

---

I'll help you set up a new git worktree for the Linear issue. Let me start by parsing the arguments and changing to the project directory.

Step 1: Navigate to Project Directory

First, I'll change to the specified project directory:

Project path: {first argument} Issue ID: {second argument}

Step 2: Fetch Linear Issue Details

I'll retrieve the issue information to get the suggested git branch name:

Let me fetch the complete issue details to determine the proper branch name for the worktree.