https://github.com/gymynnym/vscode-gitui

A VSCode extension to open GitUI/Lazygit in an integrated terminal.
https://github.com/gymynnym/vscode-gitui

git gitui lazygit vscode vscode-extension

Last synced: 2 months ago
JSON representation

A VSCode extension to open GitUI/Lazygit in an integrated terminal.

• Host: GitHub
• URL: https://github.com/gymynnym/vscode-gitui
• Owner: gymynnym
• License: mit
• Created: 2025-10-14T09:36:08.000Z (6 months ago)
• Default Branch: master
• Last Pushed: 2025-12-02T14:50:38.000Z (4 months ago)
• Last Synced: 2025-12-05T11:52:37.733Z (4 months ago)
• Topics: git, gitui, lazygit, vscode, vscode-extension
• Language: TypeScript
• Homepage: https://marketplace.visualstudio.com/items?itemName=gymynnym.vscode-gitui
• Size: 2.08 MB
• Stars: 3
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# vscode-gitui

![screenshot](./assets/screenshot.png)

[![GitHub Release](https://img.shields.io/github/v/release/gymynnym/vscode-gitui?logo=github&color=blue)](https://github.com/gymynnym/vscode-gitui/releases/latest)

[![Visual Studio Marketplace Installs](https://img.shields.io/visual-studio-marketplace/i/gymynnym.vscode-gitui?label=installs)](https://marketplace.visualstudio.com/items?itemName=gymynnym.vscode-gitui)

**A VSCode extension to open [GitUI](https://github.com/gitui-org/gitui) and [Lazygit](https://github.com/jesseduffield/lazygit) in an integrated terminal.**

### Installation

> [!IMPORTANT]

> Requires [GitUI](https://github.com/gitui-org/gitui) or [Lazygit](https://github.com/jesseduffield/lazygit) to be installed and available on your PATH.

There are 2 ways to install this extension:

1. Install from the [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=gymynnym.vscode-gitui)

2. Download VSIX file from [GitHub Releases](https://github.com/gymynnym/vscode-gitui/releases/latest)

### Commands

- `vscode-gitui.open` : Open GitUI/Lazygit in terminal

- `vscode-gitui.reload` : Reload GitUI/Lazygit on PATH

> [!WARNING]

> When running `vscode-gitui.open` in a Python environment, the extension temporarily sets the `python.terminal.activateEnvironment` setting to `false` at the workspace level for better user experience. After execution, the settings is automatically restored to its original value. (If the setting is already `false`, this step is skipped.)

### Keybindings

#### Default Keybindings

- `ctrl+alt+g` : Open GitUI/Lazygit (Linux/Windows)

- `ctrl+cmd+g` : Open GitUI/Lazygit (macOS)

#### VSCodeVim Keybindings: for nerds (Example)

```json

{

  "vim.normalModeKeyBindingsNonRecursive": [

    {

      "before": ["space", "g", "g"],

      "commands": [{ "command": "vscode-gitui.open" }]

    },

    {

      "before": ["space", "g", "r"],

      "commands": [{ "command": "vscode-gitui.reload" }]

    }

  ]

}

```

### Properties

- `vscode-gitui.useWSL` : Enable if using GitUI/Lazygit via WSL (Windows only).

- `vscode-gitui.useLazygit` : Enable if you want to use Lazygit instead of GitUI.