How do I install the Jj Workspace skill?

Run npx skillmds@latest add tomevault-io/jj-workspace in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Jj Workspace safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: WARNING, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Jj Workspace?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Jj Workspace free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Jj Workspace?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Jj Workspace by tomevault-io — Agent Skill

Name: Jj Workspace
Author: tomevault-io

File contents

jj Workspace Skill

When to Use

Parallel development: Work on multiple features simultaneously
Testing changes: Test modifications without affecting main workspace
Isolated experiments: Try approaches that might be discarded
Code review: Check out a PR while keeping current work intact

Workspace Location

Use the .wt/ prefix at repository root for all workspaces:

.wt/feature-name
.wt/bugfix-123
.wt/experiment

This keeps workspaces organized and separate from the main working directory.

Operations

Create a New Workspace

# Create workspace at .wt/<name>
jj workspace add .wt/<workspace-name>

# Create workspace and check out a specific revision
jj workspace add .wt/<workspace-name> -r <revision>

Example:

jj workspace add .wt/feature-auth
jj workspace add .wt/review-pr-42 -r @some-bookmark

List All Workspaces

jj workspace list

Work in a Workspace

Simply change directory to the workspace:

cd .wt/<workspace-name>

All jj commands will operate on that workspace's working copy.

Return to Main Workspace

cd /path/to/repository-root

Delete a Workspace

# Remove from jj's tracking
jj workspace forget <workspace-name>

# Remove the directory
rm -rf .wt/<workspace-name>

Or do both:

jj workspace forget <workspace-name> && rm -rf .wt/<workspace-name>

Best Practices

Use descriptive names: Name workspaces after the task or feature
Clean up when done: Remove workspaces after merging or abandoning work
Shared history: All workspaces share the same commit history
Independent working copies: Each workspace has its own working copy state
Bookmark association: Each workspace tracks its own current change

Example Workflow

# 1. Create workspace for a new feature
jj workspace add .wt/new-feature

# 2. Switch to the workspace
cd .wt/new-feature

# 3. Work on the feature
jj describe -m "feat: implement new feature"
# ... make changes ...
jj new

# 4. When done, return to main workspace
cd ../..

# 5. The changes are available in the main workspace too
jj log  # Shows commits from all workspaces

# 6. Clean up
jj workspace forget new-feature
rm -rf .wt/new-feature

Troubleshooting

Workspace conflicts

If the same file is modified in multiple workspaces and you try to merge:

jj resolve  # Interactive conflict resolution

Stale workspace

If a workspace gets into a bad state:

jj workspace forget <name>
rm -rf .wt/<name>
jj workspace add .wt/<name>  # Recreate fresh

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: jj-workspacedescription: Create isolated jj workspace for parallel work. Use when working on separate tasks simultaneously or testing changes in isolation. Use when this capability is needed.---# jj Workspace Skill## When to Use- **Parallel development**: Work on multiple features simultaneously- **Testing changes**: Test modifications without affecting main workspace- **Isolated experiments**: Try approaches that might be discarded- **Code review**: Check out a PR while keeping current work intact## Workspace LocationUse the `.wt/` prefix at repository root for all workspaces:- `.wt/feature-name`- `.wt/bugfix-123`- `.wt/experiment`This keeps workspaces organized and separate from the main working directory.## Operations### Create a New Workspace```bash# Create workspace at .wt/<name>jj workspace add .wt/<workspace-name># Create workspace and check out a specific revisionjj workspace add .wt/<workspace-name> -r <revision>```Example:```bashjj workspace add .wt/feature-authjj workspace add .wt/review-pr-42 -r @some-bookmark```### List All Workspaces```bashjj workspace list```### Work in a WorkspaceSimply change directory to the workspace:```bashcd .wt/<workspace-name>```All jj commands will operate on that workspace's working copy.### Return to Main Workspace```bashcd /path/to/repository-root```### Delete a Workspace```bash# Remove from jj's trackingjj workspace forget <workspace-name># Remove the directoryrm -rf .wt/<workspace-name>```Or do both:```bashjj workspace forget <workspace-name> && rm -rf .wt/<workspace-name>```## Best Practices1. **Use descriptive names**: Name workspaces after the task or feature2. **Clean up when done**: Remove workspaces after merging or abandoning work3. **Shared history**: All workspaces share the same commit history4. **Independent working copies**: Each workspace has its own working copy state5. **Bookmark association**: Each workspace tracks its own current change## Example Workflow```bash# 1. Create workspace for a new featurejj workspace add .wt/new-feature# 2. Switch to the workspacecd .wt/new-feature# 3. Work on the featurejj describe -m "feat: implement new feature"# ... make changes ...jj new# 4. When done, return to main workspacecd ../..# 5. The changes are available in the main workspace toojj log # Shows commits from all workspaces# 6. Clean upjj workspace forget new-featurerm -rf .wt/new-feature```## Troubleshooting### Workspace conflictsIf the same file is modified in multiple workspaces and you try to merge:```bashjj resolve # Interactive conflict resolution```### Stale workspaceIf a workspace gets into a bad state:```bashjj workspace forget <name>rm -rf .wt/<name>jj workspace add .wt/<name> # Recreate fresh```---> Converted and distributed by [TomeVault](https://tomevault.io/claim/xorphitus) — claim your Tome and manage your conversions.

Frequently asked questions

Jj Workspace