xiaohongshu
xiaohongshu
Set up jj repositories including colocation decisions, integrate with development tools like Vite/Vitest, and choose between jj library and CLI for tooling. Use when setting up new repositories, experiencing tool integration issues, or building jj integrations.
Full skill instructions
Key decisions:
Understanding these choices helps you set up repositories correctly and avoid common integration issues.
What is colocation?
Using jj and git in the same working directory:
my-repo/
├── .git/ # Git repository
├── .jj/ # Jujutsu repository
└── src/ # Shared working directory
Creating colocated repository:
# Initialize jj in existing git repo
cd my-git-repo
jj git init --colocate
# Or create new colocated repo
jj git init --colocate my-repo
cd my-repo
Creating jj-only repository:
# Pure jj repository (no colocation)
jj git init my-repo
cd my-repo
Advantages:
Drawbacks:
Recommendation:
| Scenario | Recommendation |
|---|---|
| Learning jj | Colocate (easier transition) |
| Team migration | Colocate (gradual adoption) |
| New personal project | jj-only (cleaner) |
| Legacy git project | Colocate (tool compatibility) |
| CI/CD requirements | Colocate (git tooling) |
Problem: jj commands slow or hang in Vite/Vitest projects.
Cause: Vite's file watcher monitors .jj directory, causing conflicts and slowdowns.
Solution: Configure Vite to ignore .jj:
// vite.config.js or vite.config.ts
export default {
server: {
watch: {
ignored: ['**/.jj/**']
}
}
}
For Vitest:
// vitest.config.js or vitest.config.ts
export default {
test: {
// ... other config
watch: {
ignored: ['**/.jj/**']
}
}
}
Complete example:
import { defineConfig } from 'vite'
export default defineConfig({
server: {
watch: {
ignored: [
'**/.jj/**', // Ignore jj directory
'**/.git/**', // Good practice to ignore git too
'**/node_modules/**'
]
}
}
})
Common issues and fixes:
File watchers:
.jj/ from watching**/.jj/** or .jjIDEs (VS Code, IntelliJ, etc.):
// .vscode/settings.json
{
"files.watcherExclude": {
"**/.jj/**": true
},
"search.exclude": {
"**/.jj/**": true
}
}
Build tools:
.jj/ to ignore patterns.git/ configurationLinters/formatters:
# .prettierignore or .eslintignore
.jj/
Question: Should I use the jj library or parse CLI output?
Answer: Both have trade-offs. Library avoids parsing but isn't stable. CLI is also unstable but more flexible.
Pros:
Cons:
When to use:
Pros:
Cons:
When to use:
# Use --no-pager for scripting
jj log --no-pager
# Use templates for structured output
jj log --template 'commit_id ++ "\t" ++ description.first_line() ++ "\n"'
# Use revsets for precise queries
jj log -r 'mine() & after("1 week ago")'
# Check exit codes
if jj status &>/dev/null; then
echo "In jj repository"
fi
Example Python integration:
import subprocess
import json
def jj_log(revset="@"):
result = subprocess.run(
["jj", "log", "-r", revset, "--no-pager",
"--template", "json"],
capture_output=True,
text=True
)
return json.loads(result.stdout)
Use this skill when:
Don't use this skill for:
For detailed setup guides, configuration examples, and integration patterns:
📚 See detailed docs: faq-reference.md
This includes:
# Repository initialization
jj git init --colocate # Colocated repo (jj + git)
jj git init # jj-only repo
jj git init --colocate existing-git-repo # Add jj to git repo
# Configuration
~/.jjconfig.toml # Global config
.jj/repo/config.toml # Repository config
# Tool integration
# Vite: Add to vite.config.js
server.watch.ignored = ['**/.jj/**']
# VS Code: Add to .vscode/settings.json
"files.watcherExclude": {"**/.jj/**": true}
Colocation is a choice, not a requirement. Use it when you need git compatibility, prefer pure jj otherwise. Always configure development tools to ignore .jj/ directory to avoid conflicts and performance issues.
xiaohongshu
technical spec
product ux expert
database patterns
Conduct multi-agent task orchestration and workflow coordination.
Initialize project with Conductor artifacts (product definition,
Expert in web animations, transitions, and motion design using Framer Motion and CSS
Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual docume...
PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.
Context-Driven Development skill for projects using Conductor. Use this skill when you detect a `conductor/` directory in the project, when working on tasks defined in a `plan.md` file, or when the user asks about tracks, specs, or plans. Automatically applies TDD workflow, tracks task completion...
Display project status, active tracks, and next actions
Official Stakpak application containerization standard operating procedure, a step-by-step guidline to properly dockerize applications. This is a rule book curated by the Stakpak Team.
Generate, edit, and beat-sync AI video with leading models in one workspace.
The world's fastest calendar for remote work
Transform Your Design with AI Designer by ImgCreator.ai
Revolutionizing Video Production with AI-Powered Creativity
Extend an image past the frame and let AI fill the new aspect ratio.
Discover your celebrity doppelgänger with StarByFace!
ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.
Opus.ai: Revolutionize Your Web Experience