Setting Up Jujutsu Repositories and Tool Integration

Set up a Jujutsu repository by deciding whether to colocate jj with git in one workspace, then configure Vite and Vitest to ignore the .jj directory. Apply ignore rules to improve developer experience and prevent tool conflicts with version control metadata.

Colocation places jj and git in one workspace for unified version control. Choose colocated layouts when integrating jj into existing git-based projects; use pure jj layouts when starting fresh without git dependencies.

Add .jj to Vite's watcher ignore rules to prevent file system events from triggering rebuilds. This configuration applies the same pattern to Vitest, eliminating redundant tool restarts caused by jj's internal directory changes.

Use the Jujutsu library when building programmatic integrations that require direct API access and tighter coupling with jj internals. Use the CLI for orchestration and scripting when loose coupling and portability matter more than performance.

Ignoring .jj prevents development tools like Vite and Vitest from watching jj's internal metadata, reducing unnecessary rebuilds and improving build performance during jj operations like commit workflows.

Validate integration by confirming .jj is excluded from file watcher rules, testing that jj operations do not trigger unexpected tool rebuilds, and verifying programmatic access points work as expected for your chosen library or CLI approach.