jj-workspaces

jj-workspace-skill

A Claude Code plugin that adds a skill for creating isolated jj (jujutsu) workspaces. Use it for parallel feature work or sub-agent driven development. When invoked from a jj-managed repo, it intercepts requests for using-git-worktrees (and freeform "create a worktree" instructions from other skills), detects jj, and substitutes the correct jj workspace equivalents.

Install

/plugin marketplace add antstanley/jj-workspace-skill
/plugin install jj-workspaces@jj-workspace-skill

What it does

• Detects jj repos via jj workspace root and takes precedence over using-git-worktrees.
• Creates workspaces as sibling directories (jj's idiomatic layout) with a verified clean test baseline.
• Supports sub-agent driven development — one workspace per parallel agent, coordinated through jj log.
• Maps common git-worktree operations to their jj equivalents (git worktree add → jj workspace add, git worktree remove → jj workspace forget + rm -rf, etc.).

See plugins/jj-workspaces/skills/using-jj-workspaces/SKILL.md for the full workflow.

Requirements

• jj installed and on $PATH.
• A jj-initialized repo (or a git repo you're willing to colocate with jj git init --colocate). Outside a jj repo the skill defers to using-git-worktrees.

Repo layout

This repo is both a Claude Code marketplace (via .claude-plugin/marketplace.json) and hosts a single plugin:

jj-workspace-skill/
├── .claude-plugin/marketplace.json
└── plugins/
    └── jj-workspaces/
        ├── .claude-plugin/plugin.json
        └── skills/
            └── using-jj-workspaces/SKILL.md