lazygit-sidecar

See your git changes while you code. Always.

What is this?

When you work in the terminal, you constantly switch between your tool and git commands. lazygit-sidecar solves this by splitting your terminal in two: your tool on the left, a live git view on the right. Outside a git repository, your tool runs normally without any split.

It works with any command-line tool: Claude Code, Codex, Gemini CLI, or just a plain shell.

Install

macOS and Linux are supported natively. On Windows, lazygit-sidecar works inside WSL.

Make sure you have tmux (3.1 or newer), lazygit, and bash 4+ installed, then run:

git clone https://github.com/Predixx/lazygit-sidecar.git
cd lazygit-sidecar
./install.sh

The installer walks you through every step and asks for confirmation before making any changes.

Non-interactive install

If you prefer to skip the prompts:

./install.sh --core

Manual install

install -m 0755 bin/lazygit-sidecar ~/.local/bin/lazygit-sidecar

If your terminal says lazygit-sidecar: command not found, add this line to your ~/.zshrc (or ~/.bashrc):

export PATH="$HOME/.local/bin:$PATH"

Usage

Just put lazygit-sidecar in front of the command you normally use:

lazygit-sidecar claude
lazygit-sidecar codex
lazygit-sidecar zsh

That's it. Your terminal splits in two. Work on the left, git on the right.

When you're done, exit your tool as usual. Close the git view by pressing q.

Note: lazygit-sidecar only opens the git view when you are inside a git repository. Outside of a git repo, your command runs normally in a plain terminal session without any split.

Uninstall

./install.sh --uninstall

Troubleshooting

lazygit-sidecar: command not found ~/.local/bin is likely not on your PATH. See the fix in Install.

already inside a tmux session lazygit-sidecar opens its own terminal session and can't run inside one that's already open. Press Ctrl-b d to leave the current session first, then try again.

tmux 3.1+ required Your tmux version is too old. Update it with brew upgrade tmux.

No git view appeared The git view only opens inside a git repository. Navigate to a folder that contains a .git directory (or is inside one) and try again. You can check with git rev-parse --is-inside-work-tree.

agent-deck integration

If you use agent-deck, you can add a hook so that every agent-deck session automatically gets a git view on attach:

./install.sh --agent-deck

This installs a tmux hook and an ad() shell alias. All changes are wrapped in markers and can be cleanly removed with ./install.sh --uninstall-agent-deck.

How it works

The entire tool is a single ~45-line shell script. When you run it:

1. It opens a new terminal session (using tmux).
2. Your command runs in the left side.
3. If the current directory is inside a git repository, lazygit opens on the right side (taking up 40% of the width). Outside a git repo, no split happens and your command runs full-width.
4. When both sides are closed, you're back to your normal terminal.

No background processes, no config files, no daemons.

License

MIT