using-jj-workspaces

Redirects git worktree requests to jj workspaces in jj-managed repositories.

7|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/antstanley/jj-workspace-skill --skill using-jj-workspaces-antstanley
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-jj-workspaces
Source: https://github.com/antstanley/jj-workspace-skill/tree/main/plugins/jj-workspaces/skills/using-jj-workspaces
Command: npx skills add https://github.com/antstanley/jj-workspace-skill --skill using-jj-workspaces-antstanley

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

jj-managed repositories often face interference when multiple agents or parallel feature work request git worktrees. This skill intercepts such requests and redirects them to jj workspaces, ensuring isolation and a verifiably clean baseline so concurrent work can proceed safely.

Core Features & Use Cases

  • Intercepts git worktree requests and translates them to jj workspace commands.
  • Creates sibling workspaces outside the main repo with a clean starting point.
  • Supports multi-agent parallel work and sub-agent driven workflows in jj-managed projects.

Quick Start

Request the creation of an isolated jj workspace in a jj-managed repo and it will set up a clean, sibling workspace outside the main tree.

Frequently Asked Questions about using-jj-workspaces

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

FAQPage Schema
How do I isolate parallel development work in a jj-managed repository?

To isolate parallel development in a jj-managed repository, you can use jj workspaces. This redirects git worktree requests to create sibling workspaces outside the main tree, ensuring concurrent work proceeds safely with a verifiably clean baseline.

Why does my git worktree setup cause interference during multi-agent workflows?

Git worktree requests in jj-managed repositories cause interference because multiple agents compete for the same tree. Intercepting these requests and redirecting them to isolated jj workspaces prevents this conflict and provides each agent a clean starting point.

How do I set up an isolated jj workspace for parallel feature work?

To set up an isolated jj workspace, request its creation in your jj-managed repo. The process intercepts standard worktree commands, translating them to create a clean, sibling workspace outside the main tree for safe parallel feature work.

Can I use git worktrees with jj-managed repositories for sub-agent driven workflows?

Yes, you can use git worktrees with jj-managed repositories for sub-agent workflows. Worktree requests are intercepted and translated into jj workspace commands, creating isolated sibling directories that support safe multi-agent parallel development.

What is the best way to manage multiple isolated baselines in jj?

The best way to manage multiple isolated baselines in jj is using workspaces. By intercepting git worktree requests, it creates sibling workspaces outside the main repo with clean starting points, avoiding interference during parallel development.

When should I avoid using git worktrees in jj-managed projects?

You should avoid standard git worktrees in jj-managed projects when running multi-agent parallel work. Without redirecting to jj workspaces, concurrent worktree requests cause interference and compromise the clean baseline needed for safe development.