News for hackers. Stuff that matters.
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by nh23423fefe on Thursday October 30, 2025 @04:55PM (#45765236)
I have never understood the claim that git is hard. the docs are good and there are plenty of examples online.

feels the same when people say, "jq is hard i use python instead" like ok

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by litenboll on Thursday October 30, 2025 @06:40PM (#45766239)
I think what people usually mean is "scary" or "it's easy to mess up". Git is very easy to use until you mess up, then it can become complicated, and certain actions may have devastating consequences.

Two examples from recent memory:

Someone merged the develop branch into their branch, then changed their mind and reverted the merge commit specifically (i.e. reversing all the incoming changes), then somehow merged all of this into the develop branch, undoing weeks of work without noticing. I had to go in and revert the revert to undo the mistake. Yes they messed up, but these things happen with enough people and time.

Another very interesting issue that happened to a less technical person on the team was that their git UI somehow opened the terminal in the wrong folder. They then tried to run some command which made git suggest to run 'git init', creating another git repo in that wrong location. Fast forward some days and we had an issue where people had to clean their repos, so I was in a call with the person helping them run the clean command. The UI opened the wrong location again, I helped them put in the command and it started cleaning. The problem was that this git repo was essentially at the top level on their disk, and since was a fresh repo every single file was considered a new file so it tried to delete EVERYTHING on their disk. This was of course mostly my fault for not running git status before the clean command, but this potential scenario was definitely not on my mind.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by Nashooo on Thursday October 30, 2025 @06:47PM (#45766286)
I mean. How can it be scary when you have git reflog.
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by steveklabnik on Thursday October 30, 2025 @06:57PM (#45766388)
The reflog doesn't capture everything. jj's oplog does.

An example of something that the reflog isn't going to capture is a git reset --hard losing your unstaged changes, whereas the equivalent flow and commands in jj would allow you to get those contents back.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by Nashooo on Thursday October 30, 2025 @07:24PM (#45766618)
That makes sense
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by 1718627440 on Friday October 31, 2025 @11:39AM (#45773295)
The thing to keep in mind is that Git doesn't version the file system, it versions the index. This is because a file system guy like Torvalds knows that the file system is a shared resource and no program should think it can control its state. Therefore a Git repository doesn't consists out of all the files below a directory, it consists out of everything in the index.

Git does version everything that is in the repository and all these states occur in the reflog.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by steveklabnik on Friday October 31, 2025 @02:26PM (#45775122)
> The thing to keep in mind is that Git doesn't version the file system, it versions the index.

Yes. I think that this difference is what introduces a lot of friction, both in the model, and how people use it. The divergence between the files that exist on disk inside your working copy and what's actually tracked means lots of opportunities for friction that go away once you decide that it should. That doesn't mean things are perfect, for example, by default jj only snapshots the filesystem when you run a `jj` command, so you can still lose changes from in between those, you need to enable Watchman to get truly full logging here.

> all these states occur in the reflog.

Well, let's go back to the documentation for reflog:

> Reference logs, or "reflogs", record when the tips of branches and other references were updated in the local repository.

It only tracks changes to refs. That is, the states that refs have been in. So, one big example is detatched HEADs: any changes you make to those, which still are contents of the repository, are not tracked in the reflog.

Even for refs, there's differences: the reflog says "ref was in state x and changed to state y" without any more details. jj's oplog keeps track of not only the state change, but the reason why: "rebased commit <sha> with these args: jj rebase -r <sha> -d trunk"

The reflog only tracks individual refs. Say we rebase multiple commits. The reflog still just says "the head of this branch was in state x and changed to state y" but the oplog says "a rebase happened, it affected all of these commits refs in these ways," that is, it's just inherently more rich in what it tracks, and does it across all relative commits, not only the refs.

This doesn't mean the reflog is bad! It's just a very specific thing. Git could have an operation log too, it's just a different feature.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by 1718627440 on Friday October 31, 2025 @04:33PM (#45776390)
> So, one big example is detatched HEADs: any changes you make to those, which still are contents of the repository, are not tracked in the reflog.

    $ git checkout HEAD
    $ git commit --allow-empty -m "_"
    $ git checkout master
    $ git reflog
    a91 (HEAD -> master, origin/master, origin/HEAD) HEAD@{0}: checkout: moving from b94 to master
    b94 HEAD@{1}: commit: _
    28d (origin/feature, feature) HEAD@{2}: checkout: moving from feature to @
> Even for refs, there's differences: the reflog says "ref was in state x and changed to state y" without any more details. jj's oplog keeps track of not only the state change, but the reason why: "rebased commit <sha> with these args: jj rebase -r <sha> -d trunk"

> The reflog only tracks individual refs. Say we rebase multiple commits. The reflog still just says "the head of this branch was in state x and changed to state y" but the oplog says "a rebase happened, it affected all of these commits refs in these ways," that is, it's just inherently more rich in what it tracks, and does it across all relative commits, not only the refs.

    68e HEAD@{15}: rebase (finish): returning to refs/heads/feature
    68e HEAD@{16}: rebase (pick): message #6
    7ff HEAD@{17}: rebase (pick): message #5
    797 HEAD@{18}: rebase (pick): message #4
    776 HEAD@{19}: rebase (pick): message #3
    c7d HEAD@{20}: rebase (pick): message #2
    f10 HEAD@{21}: rebase (pick): message #1
    c0d HEAD@{22}: rebase (start): checkout @~6

    a7c HEAD@{100}: rebase (reword): message ...
    3b1 HEAD@{229}: rebase (reset): '3b1' message ...
    4a4 HEAD@{270}: rebase (continue): message ...
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by steveklabnik on Friday October 31, 2025 @04:37PM (#45776438)
Oh yeah I forgot HEAD Is a ref, whoops. Duh! (My git is getting rusty at this point...)

jj still ends up keeping information in here that the reflog doesnt, but you're right that these aren't the strongest points.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by martinvonz on Friday October 31, 2025 @05:02PM (#45776661)
One little benefit of the op log is that you can use a single `jj undo` to undo all the rebased branches/bookmarks in one go. If you have rebased many branches with `git rebase --update-refs`, you need to reset each of the branches separately AFAIK.
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by 1718627440 on Monday November 03, 2025 @10:18AM (#45799986)

      --update-refs, --no-update-refs
           Automatically force-update any branches that point to commits that
           are being rebased. Any branches that are checked out in a worktree
           are not updated in this way.

           If the configuration variable rebase.updateRefs is set, then this
           option can be used to override and disable this setting.
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by martinvonz on Tuesday November 04, 2025 @01:04AM (#45807828)
Are you saying that that text implies that the you can undo the rebase with a single command or that all the reflogs get updated atomically? Or how is it related to the comment you replied to?
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by 1718627440 on Tuesday November 04, 2025 @03:24AM (#45808667)
Oops. No the text implies that I can't read and answered to a claim which you didn't state, namely that --update-refs can only update specific refs. (This was given by another comment.)

Yes, this is something, that JJ provides and Git does not.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by 1718627440 on Friday October 31, 2025 @04:53PM (#45776578)
Which, the stuff you said earlier is in the reflog?

I think Git will just gain a oplog. You just need to append a commit hash to a list before each command and implement undo as remove item and checkout. The hardest thing will be race conditions, but Git already knows how to be a database.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by stouset on Thursday October 30, 2025 @07:22PM (#45766611)
I am (was) a git expert. I’ve written a git implementation. I’ve used it since shortly after it was first announced.

Git has lots of sharp edges that can get hairy or at least tedious really rapidly. You have to keep a ton of random arcana in working memory at all times. And a bunch of really useful, lovely workflows are so much of a pain in the ass that you don’t even conceive of doing them.

I learned jj in one day and never went back.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by digdugdirk on Thursday October 30, 2025 @09:03PM (#45767272)
^^^ This aspect of the arcana one is required to keep in working memory is an issue that's glossed over far too frequently. I understand that git is a developer focused tool, but requiring a user to keep a constant mental burden in working memory completely bars non-developers from using git in any legitimate way.

I'm not a welder or a metalworker, but I do know how to weld. I use a welder a handful of times per year when I need/want to. Welding is dangerous, and achieving excellence is a difficult and long road. But I can use the same tools as a pro and still get a few pieces of metal stuck together without having to relearn and restudy the whole system each time something goes wrong.

I haven't used jj in anger yet, but I think it might at least be approaching that style of developer tool.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by metabagel on Thursday October 30, 2025 @06:27PM (#45766148)
From time to time, I end up in a state which I don't know how to recover from, and it's very frustrating to have to take an hour or two from my real work in order to try to figure out how to get out of that state.

https://roadrunnertwice.dreamwidth.org/596185.html

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by gorjusborg on Thursday October 30, 2025 @06:39PM (#45766233)
The reflog is the failsafe. It is the tool that fixes all the scary states, as it keeps a journal of the states of each ref in the repo (like branch heads).

You can see where you were and hard reset back, no matter what state you are in.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by steveklabnik on Thursday October 30, 2025 @06:53PM (#45766354)
If you like the reflog, you'll love jj's oplog: it's like the reflog, but for all repository state changes.
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by Agingcoder on Thursday October 30, 2025 @06:41PM (#45766249)
So based on my experience teaching git ( I remember a cvs to git migration …) , reality tells me people find git difficult.

Now, once you teach them it’s a commit graph with names, some of them floating, some people get it.

The thing is, not everyone is comfortable with a commit graph, and most people are not - just like people get lists and arrays but graphs are different.

So I agree with you on principle ( it shouldn’t be difficult), but most people don’t have a graph as a mental model of anything, and I think that’s the biggest obstacle.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by bqmjjx0kac on Thursday October 30, 2025 @05:15PM (#45765468)
I have burned git into my brain, so it's no longer hard to me. OTOH, I only pull out jq once every six months or so, and I just barely scrape by every time.
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by fernandotakai on Thursday October 30, 2025 @06:11PM (#45766011)
and i honestly would rather parse json inside ipython and then move to a script, than keep invoking `| jq` time and time again.
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by largbae on Thursday October 30, 2025 @05:21PM (#45765526)
I've worked with many folks over the years after learning myself...

The feeling of complexity comes from not yet understanding that commits are just sets of changes to files. They are then thrown off the scent by new terms like origin clone vs push and pull, merge vs rebase, HEAD increment notation vs other commit hashes.

Once people start with a local understanding of using git diff and git add -p they usually get the epiphany. Then git rebase -i and git reflog take them the rest of the way. Then add the distributed push and fetch/pull concepts.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by steveklabnik on Thursday October 30, 2025 @06:53PM (#45766350)
Even though I never found git hard, I find jj better.
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by thefifthsetpin on Thursday October 30, 2025 @06:27PM (#45766145)
I've long been facinated by how bimodal understanding of git is. I'm one of the lucky ones to whom it came naturally, but there's clearly a large population who finds git challenging even after investing significant time and effort into learning it.

I don't see this anywhere nearly as drastically with other tools.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by koiueo on Thursday October 30, 2025 @06:34PM (#45766190)
There are simply people who've rtfm and people who haven't
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by Agingcoder on Thursday October 30, 2025 @06:45PM (#45766279)
The git documentation is one of the nastiest docs ever just like the whole git ui. It’s technically entirely correct, but won’t help you understand how it works in any way.

It’s exactly like folks in 1995 telling you to rtfm when you’re trying to install Linux from a floppy disk. It’s doable, but annoying, and it’s not that easy.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by koiueo on Thursday October 30, 2025 @07:47PM (#45766819)
That's really unexpected. To me, git documentation was one of the best cleanest official docs I've ever read.

Just in case, I'm talking about the Pro Git book [0]. I remember reading it on my kindle while commuting to office by train. It was so easy to understand, I didn't even need a computer to try things. And it covers everything from bare basics, to advanced topics that get you covered (or at least give you a good head start) if you decide to develop your own jujutsu or kurutu or whutuvur.

[0] https://git-scm.com/book/en/v2

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by Agingcoder on Friday October 31, 2025 @02:56AM (#45769084)
This is exactly what I meant. https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-N...

The book says that ‘ To really understand the way Git does branching, we need to take a step back and examine how Git stores its data’ then it starts talking about trees and blobs.

At that point you’ve lost almost everyone. If you have a strong interest in vcs implementation then fine, otherwise it’s typically the kind of details you don’t want to hear about. Most people won’t read an entire book just to use a vcs, when what they actually want to hear is ‘this is a commit graph with pointers’.

I agree with you : the information is there. However I don’t think you can in good faith tell most people to rtfm this, and that was my point.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by koiueo on Friday October 31, 2025 @07:20AM (#45770792)
> I don’t think you can in good faith tell most people to rtfm this

I can, and I do.

The explanation in that book creates a strong coherent and simple mental model of git branching. I honestly can't think of a better explanation. Shorter? Maybe. But "graph with pointers" wouldn't explain it.

So let's agree to disagree.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by rmwaite on Friday October 31, 2025 @11:32AM (#45773208)
To be honest, if you’re using a tool that stores things as trees and blobs and almost every part of its functionality is influenced by that fact, then you just need to understand trees and blobs. This is like trying to teach someone how to interact with the file system and they are like “whoa whoa whoa, directories? Files? I don’t have time to understand this, I just want to organize my documents.” Actually I take that back, it isn’t /like/ that, it is /exactly/ that.
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by Agingcoder on Friday October 31, 2025 @12:56PM (#45774151)
I see your point but … trees and blobs are an implementation detail that I shouldn’t need to know. This is different from files and directories ( at least directories ) in your example. What I want to know is that I have a graph and am moving references around - I don’t need to know how it’s stored.

The git mental model is more complex than cvs, but strangely enough the docs almost invariably refer to the internal implementation details which shouldn’t be needed to work with it.

I remember when git appeared - the internet was full of guides called ‘git finally explained ‘ , and they all started by explaining the plumbing and the implementation. I think this has stuck, and does not make things easy to understand.

Please note I say all this having been using git for close to 20 years, being familiar with the git codebase, and understanding it very well.

I just think the documentation and ui work very hard towards making it difficult to understand .

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by thefifthsetpin on Thursday October 30, 2025 @06:47PM (#45766293)
That explains it for some people, but there's something more here.

Hell, I've personally mentored people who struggled with git and I could feel their struggle.

I'm not saying that learning git was an insurmountable task for them, but their struggle was not something that I had to go through.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by wbl on Thursday October 30, 2025 @10:05PM (#45767592)
Quick, what does git pull foo do if foo is a branch vs a remote and how do you fix it if you messed up/which is preferred when both exist?
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by koiueo on Friday October 31, 2025 @07:24AM (#45770817)
I've never encountered this case in real life, so I don't know. Maybe I'll try later out of curiosity.

But whatever state I'm in, I'm sure I can reset back to where I were using reflog.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by 1718627440 on Friday October 31, 2025 @04:59PM (#45776631)
> if foo is a branch

It does `git pull <default remote> foo`.

> vs a remote

It gives an error, because you haven't specified the remote.

I don't know what behaviour you find intuitive here?

> how do you fix it if you messed up/which is preferred when both exist?

git pull is YOLO mode, so I never do it, but I would just reset the branches where I want them to be? You get a summary with the old and new commit hashes, so resetting is really easy.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by hitarpetar on Friday October 31, 2025 @11:00AM (#45772714)
sometimes this is the fault of the manual and not the people
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by LtWorf on Thursday October 30, 2025 @06:41PM (#45766248)
> after investing significant time and effort into learning it.

And the significant time and effort amounts to a total of 15 seconds.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by CuriouslyC on Thursday October 30, 2025 @05:03PM (#45765325)
My perspective, git isn't hard, but coordinating git workflows in teams with a merge backlog is a real pain in the ass.
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by caconym_ on Thursday October 30, 2025 @08:56PM (#45767237)
I think people who grasp the basic idea of a commit graph and approach it in terms of "this is how I want to manipulate the graph, what are the tools that will allow me to do this?" find it easy, and people who approach it in terms of building a cookbook of commands that comprise a workflow don't.
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by stouset on Sunday November 02, 2025 @06:26PM (#45794334)
I am somebody who deeply cares about my commit graph. I want to maintain clean history, and I want to regularly amend previous commits (until merged) in order to tell a coherent story about development. I want to keep unrelated commits on separate branches, so they can be reviewed and merged independently.

I understand how to do these things, but git’s interaction model makes it tedious at best and hard at worst.

jj’s interaction model makes these things simple, straightforward, and obvious in the overwhelming majority of cases.

Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by bigstrat2003 on Thursday October 30, 2025 @09:06PM (#45767284)
Parsing json is so much easier with Python than jq, it's not even funny. That doesn't mean jq is useless, because sometimes keeping it in the shell is the best option. But in terms of ease of use jq is shit.
Re:Jujutsu at Google • Martin von Zweigbergk JJ Con [video] by hitarpetar on Friday October 31, 2025 @10:58AM (#45772687)
that's okay, it doesn't need to be your personal experience. you just need to understand that "git gud" is not a sustainable or intelligent mantra for tool design and selection