worktree

Manage jj workspace lifecycles under the .workspaces directory.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/nclandrei/dotfiles --skill worktree-nclandrei
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree
Source: https://github.com/nclandrei/dotfiles/tree/main/config/skills/worktree
Command: npx skills add https://github.com/nclandrei/dotfiles --skill worktree-nclandrei

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Backward-compatible alias for workspace lifecycle operations.

Core Features & Use Cases

  • Alias of the standard workspace workflow, supporting new, list, open, and clean commands under the .workspaces directory.
  • Respects repository conventions and requires jj workspace support; explains gracefully when not a jj repository.

Quick Start

Run worktree just like workspace to create, list, open, or clean workspaces under .workspaces.

Frequently Asked Questions about worktree

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

FAQPage Schema
How do I manage jj workspaces in a git repository?

The alias resolves the repo root and .workspaces path, manages workspaces under .workspaces, ensures .workspaces is ignored in gitignore, and prevents accidental removal of the default workspace.

What is a backward-compatible workspace alias used for?

It respects repository conventions by resolving paths and managing workspaces under .workspaces. It also ensures .workspaces is ignored in gitignore and prevents removal of the default workspace.

How do I ensure .workspaces is ignored in gitignore when using jj?

It resolves the repo root and .workspaces path, manages workspaces under .workspaces, ensures .workspaces is ignored in gitignore, and prevents removal of the default workspace during clean operations.

Can I use worktree commands if my repository does not support jj workspace?

It explicitly checks for jj workspace support and the .workspaces directory, resolving repo root paths to manage workspaces while ensuring .workspaces is ignored in gitignore and protecting the default workspace.

How do I safely clean jj workspaces without removing the default?

The alias manages workspaces under .workspaces, ensures .workspaces is ignored in gitignore, and resolves the repo root to protect the default workspace from being accidentally removed.