linear-worktree

Create a git worktree for a Linear issue beside the current repository.

Updated Sep 10, 2025

Search Tags:#git #worktree #linear #parsing #dev-workflow #branch-derivation

Ready to run

npx skills add https://github.com/tillysoso/mv1 --skill linear-worktree-tillysoso

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: linear-worktree
Source: https://github.com/tillysoso/mv1/tree/main/.claude/skills/linear-worktree
Command: npx skills add https://github.com/tillysoso/mv1 --skill linear-worktree-tillysoso

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates a git worktree for a Linear issue as a sibling of the current repository, allowing you to work on the issue without affecting the main repo.

Core Features & Use Cases

Derives ISSUE_ID and BRANCH from a Linear URL, a copy as prompt, or an issue id.
Creates a deterministic worktree path alongside the current repository and checks out the main branch.
Handles common edge cases and provides clear instructions to switch to the new worktree when done.

Quick Start

Provide a Linear URL, a copy as prompt, or an issue ID to generate and set up a worktree beside the current repository.

Frequently Asked Questions about linear-worktree

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I create a git worktree for a Linear issue next to my current repository?▼

To create a git worktree for a Linear issue, provide a Linear URL, copy-as-prompt, or issue ID. The tool derives the issue ID and branch, runs git fetch origin main, and adds the worktree as a sibling to your current repository.

Can I use a Linear URL or issue ID to automatically derive a git branch name?▼

Yes, you can use a Linear URL, a copy-as-prompt, or an issue ID to automatically derive the ISSUE_ID and BRANCH. This parsed information is used to check out the target branch in the new worktree.

What is the best way to work on a Linear issue without affecting my main git repository?▼

Creating a git worktree as a sibling of your current repository lets you work on a Linear issue without affecting the main repo. It fetches the main branch and checks out the derived branch at a deterministic sibling path.

Does the Linear worktree creation process require any specific git dependencies or local environment setup?▼

The process requires a local git environment capable of running git fetch origin main and git worktree add. No external skill dependencies are needed, but the current repository must exist to derive the sibling worktree location.

How does the tool determine the file path location when adding a new git worktree?▼

The tool determines the worktree path by creating a deterministic sibling location alongside your current repository. It uses the parsed Linear issue data to define the target path before running the git worktree add command.

What should I do after successfully creating a git worktree for my Linear issue?▼

After creating the git worktree, the tool provides clear instructions to switch to the new worktree directory. You can then start working on your Linear issue in this isolated environment without impacting the main repository.