Skip to content

Add support for suspending LazyGit with Ctrl+Z on Unix systems #4757

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 8 commits into
base: master
Choose a base branch
from

Conversation

cowboy8625
Copy link

@cowboy8625 cowboy8625 commented Jul 19, 2025

✨ Add Ctrl+Z suspend support for LazyGit on Unix-like systems

πŸ“ Summary

This PR adds support for suspending LazyGit when the user presses Ctrl+Z, making it behave like common CLI tools (e.g., Vim, less, htop):

  • Pressing Ctrl+Z sends a SIGTSTP signal to suspend LazyGit.
  • After resuming with fg, LazyGit redraws and continues working without hanging.
  • During suspension, background routines are paused to avoid running while LazyGit is stopped.

βœ… Motivation

Make LazyGit feel more native on Unix-like systems by supporting standard terminal suspend/resume (Ctrl+Z / fg) behavior.

  • Please check if the PR fulfills these requirements
  • Cheatsheets are up-to-date (run go generate ./...)
  • Code has been formatted (see here)
  • Tests have been added/updated (see here for the integration test guide)
  • Text is internationalised (see here)
  • If a new UserConfig entry was added, make sure it can be hot-reloaded (see here)
  • Docs have been updated if necessary
  • You've read through your own file changes for silly mistakes etc

Closes #3906

@cowboy8625 cowboy8625 changed the title Allow ctrl-z to suspend lazygit Add support for suspending LazyGit with Ctrl+Z on Unix systems Jul 19, 2025
@cowboy8625
Copy link
Author

@stefanhaller I’ve addressed the earlier issues you pointed out. I’m not sure if a test is needed for this change, or if there are any other steps you’d expect before merging. Let me know! πŸ™‚

@stefanhaller
Copy link
Collaborator

@cowboy8625 The behavior is still the same for me, as described in #3906 (comment). After typing bg, I get the "+ suspended (tty output)" error, and then fg hangs.

(We had a similar problem back when we used $SHELL -i for running custom shell commands; see #3903 (comment) for some discussion. Not sure how much of a connection there is between the two cases; just mentioning it.)

And finally, when I use make run to start lazygit, then ctrl-z doesn't work at all; lazygit does suspend, but the shell prompt doesn't appear. This may be only relevant for developers, not users, but the same could happen for users if they launch lazygit through a wrapper script. I suppose in this case we'd have to send the SIGTSTP to the wrapper script (or to the make process in my case), not to lazygit; but I'm not sure what the criterion for that is. Walk the chain of parent processes until we find one whose name matches $SHELL?

Until these problems are solved I don't feel we can merge this. But I'm also not sure how much time is justified for putting into this, to be honest.

@cowboy8625
Copy link
Author

@stefanhaller I was able to better handle the issue where running bg followed by fg would cause lazygit to hang.

Here’s how it looks now on macOS (Kitty terminal):

image

And here’s how Neovim behaves:

image

I also resolved the issue that happened when running via make run.
By looking at how Neovim handles suspension, I noticed they call kill(0, SIGSTOP) in their code:
https://github.com/neovim/neovim/blob/c3a4d125296caaf15ff424e7609e731a8b4d37e7/src/nvim/tui/tui.c#L1611-L1627

Previously, I was only sending a stop signal to the lazygit process itself, which doesn’t work properly if it’s launched inside a wrapper or make run.
Using kill(0, SIGSTOP) sends the signal to the whole process group, which solves this.

Thanks a lot for your help!

stefanhaller and others added 7 commits August 4, 2025 13:40
- Remove old-style build tags (the +build syntax has become obsolete with 1.17)
- Remove redundant build tags from '*_windows.go' files
This should have been removed in 8c574f8, where I renamed it back to 'gui'
to fix a linter warning.
This frees up ctrl-z for suspend. Hopefully, redo is not such a frequently used
operation that the change annoys people.

Co-authored-by: Stefan Haller <stefan@haller-berlin.de>
These suspend/resume the gocui layer and pause/unpause background refreshes.
Co-authored-by: Stefan Haller <stefan@haller-berlin.de>
@stefanhaller
Copy link
Collaborator

Nice, seems like we're getting somewhere with this. πŸ˜„

I had to make quite a few changes, and I took the opportunity to also restructure the commits to make them reviewable. I didn't want to force-push your master branch, so I pushed a new branch suspend-on-ctrl-z in this repo; you can hard-reset yours to that one after reviewing it.

A few notes about what I changed:

  • we need a keybinding config; not because users may want to use a different key (that wouldn't make much sense), but because users might want to disable it
  • we need to hook this into the normal keybinding mechanism; simply calling SetKeybinding like you did in your branch doesn't work, this gets erased again the next time you open a different repo or even just a menu
  • I decided to handle the keybinding in GlobalController; unfortunately this requires some indirections to call things on Gui, which I'm not entirely happy about, but we do similar things all over the place. Another option would have been to handle it in GetInitialKeybindings, that way we would have been able to work with Gui directly; however, I really wanted the binding to appear right below 'Quit' in the keybindings menu, and handling it in GlobalController seems like the only way to achieve that.
  • When you type ctrl-z on Windows, there's an error toast in the status bar.

During testing I still had one or two cases where lazygit didn't come back to the foreground after typing fg, and I had to kill it from another terminal tab. This makes me a little nervous, but it might also have been an intermediate state during refactoring; I can no longer reproduce it. (Shrug)

@cowboy8625
Copy link
Author

Yeah, this is a lot cleaner.

@cowboy8625
Copy link
Author

@stefanhaller Am I good to open this up for review? πŸ˜„

@stefanhaller
Copy link
Collaborator

@stefanhaller Am I good to open this up for review? πŸ˜„

I'd say so, yes. I'll hold off merging this for now until after we released 0.54.1, which I expect to happen tomorrow or the day after; that's a hotfix (needed because of #4793), and I don't want to include any other changes there.

To be honest I don't really fully understand what we're doing here when we wake up, like what this /dev/tty business is or why we need it. I was trying a little bit to read up on what vim is doing in that case, and it makes me dizzy πŸ˜….

But it seems to work well, so I'm fine with going with this for now.

@stefanhaller stefanhaller added the enhancement New feature or request label Aug 5, 2025
@cowboy8625
Copy link
Author

To my knowledge this is the most reliable way to handle it. By opening /dev/tty, we can always access the controlling terminal regardless of how Lazygit is launched. Standard input/output might be redirected depending on how the program is run, so relying on them isn’t safe. Using /dev/tty ensures we can always call TIOCSPGRP to regain foreground status after receiving a SIGCONT.

@cowboy8625 cowboy8625 marked this pull request as ready for review August 5, 2025 23:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Allow ctrl-z to suspend lazygit
2 participants