CLAUDE.md – JJ Quick Command List
A concise cheat sheet for essential Jujutsu (`jj`) version control commands, designed to help AI agents or users quickly perform common repository operations.
About this skill
This AI agent skill provides a streamlined reference for the most frequently used Jujutsu (`jj`) version control commands. It functions as a quick-access cheat sheet, enabling AI agents to efficiently navigate and manipulate `jj` repositories. The skill outlines key operations such as viewing changes, browsing history, starting new changes, committing messages, splitting commits, and managing branches, all within the context of Jujutsu's unique workflow. The primary goal is to empower AI agents to interact with `jj` repositories without needing to parse extensive documentation. By presenting commands alongside their purposes and descriptions, the skill simplifies the agent's task of translating user requests into appropriate `jj` actions. This is particularly useful for automated code management, development tasks, or even teaching users how to interact with `jj` via an AI assistant. Users or agents leveraging this skill can quickly identify the correct `jj` command for common tasks like checking repository status, creating new commits, undoing operations, or pushing changes. It focuses on the practical, day-to-day operations that are most crucial for efficient software development workflows.
Best use case
The primary use case is to enable AI agents to effectively manage code within Jujutsu (`jj`) version control repositories. Developers and teams using `jj` can benefit by integrating this skill into their AI-powered coding assistants, allowing the AI to assist with commit management, history browsing, and synchronization without direct manual command input. This skill bridges the gap between natural language requests and specific `jj` command executions.
A concise cheat sheet for essential Jujutsu (`jj`) version control commands, designed to help AI agents or users quickly perform common repository operations.
An AI agent will accurately identify and provide or execute the correct Jujutsu (`jj`) commands to fulfill common version control requests.
Practical example
Example input
Hey Claude, I've made some changes. How can I see what files I've modified and what the current commit is in my `jj` repository?
Example output
`jj status` will show you the working-copy commit and any staged/unstaged file modifications. (Or, if the agent can execute: "Running `jj status`... [output of jj status]")
When to use this skill
- When an AI agent needs to perform common version control operations in a `jj` repository.
- To quickly look up the syntax and purpose of essential `jj` commands.
- For automating routine `jj` tasks or generating `jj` commands based on user prompts.
- To assist new `jj` users or agents unfamiliar with the tool's specific commands.
When not to use this skill
- When working with Git-only repositories where `jj` is not installed or configured.
- For highly complex or niche `jj` operations not covered by the quick command list.
- When an agent needs deep conceptual understanding or advanced debugging of `jj` internals.
- If the user prefers to manually execute all `jj` commands directly.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/jj/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How CLAUDE.md – JJ Quick Command List Compares
| Feature / Agent | CLAUDE.md – JJ Quick Command List | Standard Approach |
|---|---|---|
| Platform Support | Claude | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | easy | N/A |
Frequently Asked Questions
What does this skill do?
A concise cheat sheet for essential Jujutsu (`jj`) version control commands, designed to help AI agents or users quickly perform common repository operations.
Which AI agents support this skill?
This skill is designed for Claude.
How difficult is it to install?
The installation complexity is rated as easy. You can find the installation instructions above.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
ChatGPT vs Claude for Agent Skills
Compare ChatGPT and Claude for AI agent skills across coding, writing, research, and reusable workflow execution.
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
SKILL.md Source
# CLAUDE.md – JJ Quick Command List
A minimal cheat‑sheet of the day‑to‑day **Jujutsu (`jj`)** commands you (or an agent) really need.
| Purpose | Command | What it does |
| ----------------------------- | -------------------------------------- | ----------------------------------------------------------------- |
| **See changes** | `jj status` | Show working‑copy commit and staged/unstaged file modifications |
| **Browse history** | `jj log` | One‑line graph of commits; add `-r : --git` to include Git hashes |
| **Diff current work** | `jj diff` | Compare working‑copy commit to its parent (like `git diff`) |
| **Start a new change** | `jj new` | Fork a fresh change from `@` (no checkout dance) |
| **Write/update message** | `jj describe -m "msg"` | Sets commit message of the working change |
| **Split hunks interactively** | `jj split` | Launches diff‑editor to carve current change into smaller ones |
| **Undo last (or any) op** | `jj undo` | Reverts the specified operation in the op‑log |
| **List operations** | `jj op log` | Shows numbered operation history for quick undo/restore |
| **Push** | `git push origin @` *or* `jj git push` | Uses standard Git remotes; your CI never notices |
| **Pull / rebase** | `git pull --rebase` | JJ auto‑rebases local changes on fetch |
| **List branches (bookmarks)** | `jj branch list` | Display bookmarks pointing at changes |
| **Create branch** | `jj branch create feature` | Label current change as *feature* |
| **Move branch** | `jj branch set feature REV` | Point bookmark *feature* at another revision |
| **Delete branch** | `jj branch delete feature` | Remove bookmark label |
### Safety net
* `jj op restore <op‑id>` — time‑travel repo back to any previous operation (and still `jj undo` later)
* Everything is undoable; when in doubt, run `jj op log` followed by `jj undo`.
### Automation tips
* Pass `--no-editor` on `describe`, `split`, etc., in headless scripts.
* Prefer `--template '{id} {description|escape_json}\n'` for JSON‑friendly output.
---
For deeper dives, see the full JJ tutorial and command reference, but this page should cover 95 % of daily work.Related Skills
claude-code-dispatch
Dispatch development tasks to Claude Code with automatic callback on completion. Supports Agent Teams (multi-agent parallel dev with dedicated Testing Agent), cost controls (--max-budget-usd), model fallback, git worktree isolation, custom subagents via --agents JSON, and MCP server integration. Use when: (1) dispatching a coding task to Claude Code and wanting automatic Telegram notification on completion, (2) running Agent Teams for parallel dev+test workflows, (3) needing zero-polling task execution with Stop Hook callback, (4) the user says 'use Claude Code to build/develop/create X', (5) the user asks to dispatch or run a Claude Code task. THIS IS THE DEFAULT for any 'build/develop/create a project' request — prefer this over claude-code-clawdbot for anything that takes >2 min or needs background execution.
collaborating-with-claude-code
Delegate code implementation/review/debugging/alternatives to Claude Code via a JSON bridge script. Multi-turn via SESSION_ID.
laravel-expert
Senior Laravel Engineer role for production-grade, maintainable, and idiomatic Laravel solutions. Focuses on clean architecture, security, performance, and modern standards (Laravel 10/11+).
webmcp
This skill guides AI agents in implementing WebMCP within web projects, enabling browser-native structured tools for AI interaction using JavaScript or HTML APIs.
Prompt Coach
Analyze your Claude Code session logs to improve prompt quality, optimize tool usage, and enhance your skills as an AI-native engineer.
nextjs
Provides comprehensive Next.js routing capabilities, including typed routes, helpers for `PageProps` and `LayoutProps`, and `nuqs` for managing URL state.
react
This AI agent skill guides the generation of modern React components, incorporating best practices such as destructured props, leveraging compiler optimizations, and proper use of React Effects. It also ensures compatibility and utilizes Tailwind CSS v4 syntax.
just
Use `just` to save and run project-specific commands. Use when the user mentions `justfile`, `recipe`, or needs a simple alternative to `make` for task automation.
chrome-debug
This skill empowers AI agents to debug web applications and inspect browser behavior using the Chrome DevTools Protocol (CDP), offering both collaborative (headful) and automated (headless) modes.
worktree-manager
Create, manage, and cleanup git worktrees with Claude Code agents across all projects. USE THIS SKILL when user says "create worktree", "spin up worktrees", "new worktree for X", "worktree status", "cleanup worktrees", "sync worktrees", or wants parallel development branches. Also use when creating PRs from a worktree branch (to update registry with PR number). Handles worktree creation, dependency installation, validation, agent launching in Ghostty, and global registry management.
clearshot
Structured screenshot analysis for UI implementation and critique. Analyzes every UI screenshot with a 5×5 spatial grid, full element inventory, and design system extraction — facts and taste together, every time. Escalates to full implementation blueprint when building. Trigger on any digital interface image file (png, jpg, gif, webp — websites, apps, dashboards, mockups, wireframes) or commands like 'analyse this screenshot,' 'rebuild this,' 'match this design,' 'clone this.' Skip for non-UI images (photos, memes, charts) unless the user explicitly wants to build a UI from them. Does NOT trigger on HTML source code, CSS, SVGs, or any code pasted as text.
osgrep
Semantic code search using natural language queries. Use when users ask "where is X implemented", "how does Y work", "find the logic for Z", or need to locate code by concept rather than exact text. Returns file paths with line numbers and code snippets.