Skip to content

docs: jj workspaces live inside the repo under .workspaces #20

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
runewright wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: jj workspaces live inside the repo under .workspaces #20

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion skills/JujutsuToolkit/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ General rule: under jj, a git-hook-based check becomes a pre-push check (run by

## Parallel agents

Multiple agents editing one working copy still collide at the file level; jj only removes the index collision. Give each agent its own working copy sharing one store: `jj workspace add ../repo-agent-1` creates an isolated directory and `@` backed by the same history and op log. This is the jj-native replacement for the git-worktree lifecycle (no manual create / rebase / remove / delete-branch). Companions: `jj workspace list`, `jj workspace forget`.
Multiple agents editing one working copy still collide at the file level; jj only removes the index collision. Give each agent its own working copy sharing one store: `jj workspace add .workspaces/agent-1` creates an isolated directory and `@` backed by the same history and op log. Workspaces live in `.workspaces/<name>` inside the repo, ignored by `.gitignore`; sibling directories (`../repo-<name>`) pollute the parent directory and break IDE workspace paths. This is the jj-native replacement for the git-worktree lifecycle (no manual create / rebase / remove / delete-branch). Companions: `jj workspace list`, `jj workspace forget`.

@macroscopeapp macroscopeapp Bot Aug 4, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟠 High JujutsuToolkit/SKILL.md:35

The guidance states that .workspaces/<name> is ignored by .gitignore, but the repository's .gitignore has no .workspaces/ entry — it only ignores .worktrees/. Running jj workspace add .workspaces/agent-1 therefore creates a nested working copy that is not excluded from the outer workspace, so the parent @ can snapshot the inner workspace's files and contaminate the parent change with unrelated agent edits. Either add .workspaces/ to .gitignore before recommending this layout, or remove the claim that the directory is already ignored.

🚀 Reply "fix it for me" or copy this AI Prompt for your agent: 
In file @skills/JujutsuToolkit/SKILL.md around line 35:

The guidance states that `.workspaces/<name>` is ignored by `.gitignore`, but the repository's `.gitignore` has no `.workspaces/` entry — it only ignores `.worktrees/`. Running `jj workspace add .workspaces/agent-1` therefore creates a nested working copy that is not excluded from the outer workspace, so the parent `@` can snapshot the inner workspace's files and contaminate the parent change with unrelated agent edits. Either add `.workspaces/` to `.gitignore` before recommending this layout, or remove the claim that the directory is already ignored.


## Recovery

Expand Down
Loading