jj-workflow

Create isolated per-feature JJ workspaces sharing a single git graph.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/alva-intelligence/agentic-workflows --skill jj-workflow-alva-intelligence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jj-workflow
Source: https://github.com/alva-intelligence/agentic-workflows/tree/main/skills/jj-workflow
Command: npx skills add https://github.com/alva-intelligence/agentic-workflows --skill jj-workflow-alva-intelligence

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

JJ workflows enable teams to run multiple features in parallel by creating isolated, colocated workspaces that share a single git graph, preventing cross-feature interference while preserving workspace tooling.

Core Features & Use Cases

  • Creates per-feature workspaces in JJ colocated mode across api/, web/, ai-service/, data-service/ repos.
  • Maintains a single commit graph while giving each feature its own working directory for independent sessions.
  • Integrates with the primary workspace's tooling configurations and MCPs to avoid drift and prompts across workspaces.

Quick Start

Start a new JJ workspace from the primary workspace using /jj-workflow new <slug>.

Frequently Asked Questions about jj-workflow

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

FAQPage Schema
How do I create isolated workspaces for parallel feature work in jj?

You can create isolated workspaces for parallel feature work in jj by running the new command with a slug from your primary workspace. This provisions a per-feature working directory in JJ colocated mode while sharing a single git graph across multiple repositories.

What is JJ colocated mode and how does it handle multiple repositories?

JJ colocated mode maintains a single shared commit graph while giving each feature its own independent working directory. This mechanism supports multi-repo scenarios across api, web, ai-service, and data-service directories without cross-feature interference.

Can I run parallel terminals for different features using a shared git graph?

Yes, you can run parallel terminals for different features using a shared git graph. The workflow establishes primary and secondary workspace roles, allowing engineers to run independent sessions across multiple repositories simultaneously without interference.

How do I prevent port conflicts when running parallel feature workspaces?

To prevent port conflicts when running parallel feature workspaces, the workflow includes built-in port-conflict guards. These guards automatically manage port assignments across your isolated working directories during parallel terminal sessions.

Does the jj-workflow skill support tooling configurations from the primary workspace?

Yes, the jj-workflow skill integrates with the primary workspace's tooling configurations and MCPs. This prevents configuration drift and avoids duplicate prompts across your isolated per-feature workspaces.

What commands are available for managing jj isolated workspaces?

Available commands for managing jj isolated workspaces include init, new, list, status, refresh-perms, and cleanup. These commands enforce colocated mode, manage primary and secondary workspace roles, and handle port-conflict guards.