Tracking Issue: git integration

[mrnugget]

Problem

Our current git integration is very minimal. What we have:

• showing current branch, selecting branches
• showing git status in gutter, until changes are staged
• showing git status in project panel
• navigating to previous/next hunk

Many users are asking for more git integration:

• A "git panel" similar to the VS Code one: Source control view panel #4367
• A diff view for things that changed: Add a diff view #4523
• Ability to interact with git status gutter and undo changes: Show visual diff / rollback options when clicking changed lines indicator #4630

Goal

Build a 0.1 of git integration that fixes immediate pain points and stops users from leaving Zed to go to GitHub, GitLab, or another editor to use a git feature.

The most common git interactions should be doable inside Zed: committing, staging, unstaging, viewing diffs, ...

They should allow keyboard-only workflow.

Current status

Work on git integration is paused at the moment, since we're spread too thin on a lot of other projects.

Roadmap

Ranking here very subjective and based on personal pain points.

Milestone 1 - git blame

• git blame in gutter, toggle on off - Add git blame #8889
• git blame inline in the editor - Inline git blame #10398
• More information in git blame tooltips
  • Links to PR: Add pull requests to git blame tooltip #10784
  • Avatars: git blame: Display GitHub avatars in blame tooltips, if available #10767

Milestone 2 - git diff

• Support diffs
  • Allow opening diffs from git status view

Milestone 3 - git status & git commit

• git status view
  • see: working directory is clean or dirty
  • see: untracked, unstaged, staged files
  • do: stage/unstage files
• git commit
  • triggered from git status view
  • opens git commit message

Things we have to do

• Support opening sub-folders (or single files) of git repositories

Milestone ...

• History (see: History commit #10807)
• ...

[Moshyfawn]

I think #8663 can be added here.

[d1y]

I am really looking forward to using most of the gitsigns.nvim features in zed: #6780

[jaskerv]

Can I add a feature request for a option to have file changed in a tree view? 🙏

[justAdevTV]

I want git blame

[uroybd]

Conventional commit support in git commit will be great.

Alternatively, we can allow plugins to take care of these things like this one: https://marketplace.visualstudio.com/items?itemName=vivaxy.vscode-conventional-commits

[taunusflieger]

Would be nice if you work in a folder below the git root and get ask if you want to locate the repo (as it is done in vscode). Currently if you are not opening the git root, but a sub directory git support is not enabled.

[savoygrizzly]

Just wanted to drop in there that the new git integration should allow for multiple git's inside an open folder, I like to be able to have my container open so I can work on multiple services at the same time.

[Ph0enixKM]

We could also have some form of Merge Editor like it is in Visual Studio Code or maybe something even better

[fhamm]

It would also be great if the proposed source control view is compatible with git submodules, similar to VS Code =)

[Moshyfawn]

@mrnugget you might want to link to #10807 where you mention the history milestone.

[mrnugget]

Update here: we're going to pause work on the git integration for a few weeks, since we have a lot of projects going on right now — Tasks, Linux, remoting, AI — and are spread a bit too thin. Since we've reached a good pause-point here (just checked off Milestone 1), we'll pause work on git, focus on other projects for a while and then come back to git integration once we've finished other projects or reached significant milestones.

[SomeoneToIgnore]

To soften the wait slightly, I hope to finish and merge #11080 that enabled git hunk diffs browsing in the editor.
It's not a full diff view, but something useful still.

[indrajit-roy]

@mrnugget Can the community contribute to this? It would be nice to see the approach and design hosted somewhere so that interested folks can help speed up the process. I myself would like to switch to Zed permanently and am more than willing to help ship this asap. This is a huge and the only blocker for me right now.

[SomeoneToIgnore]

Of course it can, this is the whole point of Zed being open source.

I would suggest starting from something small-scoped, come up with the proposals and (ideally) some design drafts to discuss it first — defining the right chunk of work is the most complicated first step here, it seems.

Be wary that some subtasks of this "epic" are quite hard, e.g. the whole "show a two panel diff" story will require writing something like https://github.com/zed-industries/zed/blob/main/crates/editor/src/display_map/inlay_map.rs but for git things.

[indrajit-roy]

Of course it can, this is the whole point of Zed being open source.

I would suggest starting from something small-scoped, come up with the proposals and (ideally) some design drafts to discuss it first — defining the right chunk of work is the most complicated first step here, it seems.

Of course. Just want the existing specs to be highlighted so that anyone taking this up doesn't re think anything that's already decided on.

[SomeoneToIgnore]

I suspect there's nothing well formed, covering the entire integration task, only a few ideas split between people (right now I work on something related to diffs, there are some design drafts, etc.).
See also notes in the https://zed.dev/channel/git-5484 channel for a rough plan on how to move it forward.

So, any proposal could easily be better than the current state. I would not take too much of an effort to draw detailed designs, as @\iamnbutler might have better ideas, but otherwise anything is free to be picked up due to #8665 (comment)

[mrnugget]

Anyone's free to help, sure, although I would caution against picking up one of the bigger items — git commit view, git status view, git diff view — since they require a lot of design and conceptual thinking up front on and the Zed team does have opinions on all of them, we just need to find the time to get to it.

[MarcARoberge]

May I suggest a small increment for the git diff view? With the help of the hunk feature recently merged, we could add a "filter" to only see in the project panel the files with the git-status changed. This way we could get a list of all files and if we want to see the diff, we could use the expand all hunks feature for now.

[ophilli]

It would be really nice to have a "Right Click > Open in github.com" or similar for lines that have a clear git blame.

[mrnugget]

It would be really nice to have a "Right Click > Open in github.com" or similar for lines that have a clear git blame.

@ophilli: You can already click on the commit sha here to open it on the code host:

But I also just opened this PR: #11734

[kevinfaveri]

May I suggest a small increment for the git diff view? With the help of the hunk feature recently merged, we could add a "filter" to only see in the project panel the files with the git-status changed. This way we could get a list of all files and if we want to see the diff, we could use the expand all hunks feature for now.

hey @mrnugget this seems a really low hanging fruit, allowing to filter files in files view by git status being modified. Is anything we can expedite quickly? Would really help with easily going to files that got modified in a "stable sidebar"

[SomeoneToIgnore]

@kevinfaveri

I would argue about really easy, as the devil is in the ergonomics details.
The main line of questions to your proposal is: what to do with those filtered items in the project panel? Given most other tool experience, there should be click listeners, showing the diffs somewhere, how Zed is supposed to display this and how all those items are interacting with each other?

My current idea is to reuse current git hunk diffs (inline diffs) functionality, and show all changed places of a singleton buffer inside of a multi buffer (as for search results: we do not show the entire file with multiple matches inside, but rather show take excerpts around the matches and show those in a multi buffer), with the diff hunks expanded always (?).

As a first attempt, I will use a single multi buffer for all file entries, and get a project panel to show only the entries, related to excerpts of that large multi buffer — those will be all files that have some git changed metadata (modified/added/removed/conflict/etc.).
Project panel now only shows real files, but that might not be very ergonomic for large files with many changes, so some fake entries might be required.
And whatever the entries are, they still have to support previous project panel features, but for a companion multi buffer now:

• select a corresponding file when multi buffer's selection changes, also support a reveal action
• scroll to an excerpt when clicking a project panel entry (instead of opening the editor for the file as we only do now)
• directory expands/unexpands and fold/unfolds

Currently, I have a main...kb/buffer-panel branch that, while not related to the git diff explicitly, allows to have a companion "project panel" for any generic multi buffer, with the practical emphasis on the project search view.

Moreover, this is the first time in project panel's code history to add some filters on top of the current "all files in the project"-only approach, and besides all the above, it has to deal with performance implication — we can definitely do better than the branch does currently.

---

So, I think I'm getting there and the road is interesting and possible conceptually.
A good amount of work and wiring has to happen along the way though, so maybe I'm not over by the end of June but who knows.

[joaodlf]

I would recommend the Zed team (or anyone building software like this) to take a look at the way Jetbrains handles git integration. From basic functionality like commit/pull, to the amazing log interface, as well as the individual file history feature that fits into the git log UI. Even small things like being able to quickly open a file+line number in GitHub/Gitlab. Jetbrains has completely nailed their git integration, it's a fundamental aspect of my productivity and very hard to move away from.

edit: in fact, this thing is so good, the community is asking for a standalone git client from them: https://youtrack.jetbrains.com/issue/IJPL-72504/Make-git-client-a-standalone-app

[indrajit-roy-sc]

Completely agree with @joaodlf

If Zed can nail JetBrains' level Git integration and at the same time keep the memory consumption close to what it is right now, it will be the hugest win in the world of IDEs.

[cole-abbeduto-particle]

Would love to see a list of remote branches to be able to easily select in the dropdown like Webstorm has 🙏

[szabba]

As a counterpoint: I personally avoid most git-related features in IntelliJ like the plague - with the exception of 3-way merge. The UI is complex and confusing, I recall operations having non-git names - I've learned git first, IntelliJ second, so that's beyond unhelpful. I've found that when I use VS Code I use the provided git integration much more readily.