Understanding Jujutsu Bookmarks and Remotes

Resolve jj bookmark movement and git push synchronization issues.

78|6|Updated May 19, 2017
One-click install
npx skills add https://github.com/edmundmiller/dotfiles --skill understanding-jujutsu-bookmarks-and-remotes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Understanding Jujutsu Bookmarks and Remotes
Source: https://github.com/edmundmiller/dotfiles/tree/main/config/claude/plugins/jj/skills/jj-bookmarks-and-remotes
Command: npx skills add https://github.com/edmundmiller/dotfiles --skill understanding-jujutsu-bookmarks-and-remotes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill teaches how to use bookmarks, push changes to git remotes, and manage push strategies for JJ-based workflows.

Core Features & Use Cases

  • Bookmark management: Create, move, delete, and push bookmarks.
  • Git integration: Push by bookmark, or push all bookmarks to remotes.
  • Remotes and tracking: How to track remote bookmarks and handle conflicts.

Quick Start

Create a bookmark on your current commit and push it to a remote with jj git push --bookmark <name>.

Frequently Asked Questions about Understanding Jujutsu Bookmarks and Remotes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I push changes to a git remote using jj bookmarks?

Push bookmarks to remotes with jj git push --bookmark <name>. Bookmarks track commits and synchronize with git branches, allowing you to push your work without manually managing branch names.

Why doesn't my bookmark move after jj new or jj commit?

Bookmarks don't move automatically on new commits by default. Use jj commit --change to auto-create or update a bookmark, or manually move bookmarks with jj bookmark move to keep them synchronized with your current work.

What does 'Nothing changed' mean when I run jj git push?

'Nothing changed' occurs when no bookmarks or changes exist to push to the remote. Create bookmarks on your commits with jj bookmark create, then push with jj git push --bookmark or jj git push to synchronize your work to git remotes.

Can I create and push bookmarks in a single operation?

Yes. Use jj commit --change with a bookmark flag to auto-create a bookmark on your commit, then push it immediately with jj git push --bookmark <name> to resolve the commit to a remote branch in one workflow.

How do I track and resolve conflicts with remote bookmarks?

List remote bookmarks with jj bookmark list to see tracking state. Resolve conflicts by moving local bookmarks to match remote heads or by pushing your local bookmark to overwrite the remote, then pull changes back into your workspace.

What's the difference between creating bookmarks with jj bookmark create versus jj commit --change?

jj bookmark create adds a bookmark to an existing commit without modifying it. jj commit --change auto-creates a bookmark during commit creation, streamlining bookmark and commit creation for workflows that need both operations together.