gitwig

🚀 Installation & Running

Prerequisites

Gitwig requires the following external tools to be installed on your system:

• git: A system installation of git is required in your PATH for operations like staging, diffing, pushing, pulling, and network syncing.
• ssh: Required if you use SSH-based Git remotes for network operations.

  [!NOTE] SSH Host Key Policy: To prevent connection hangs in the non-interactive TUI context, Gitwig executes git commands with GIT_SSH_COMMAND set to ssh -o StrictHostKeyChecking=accept-new. This automatically trusts and saves new host keys, while verifying existing ones to protect against MITM attacks. If you require a different SSH policy, make sure to add host keys to your known_hosts beforehand.

Via Homebrew (macOS / Linux)

You can tap and install Gitwig using Homebrew:

brew tap tareqmy/tap
brew install gitwig

Note: If Homebrew prompts you with an “untrusted tap” error, run brew trust tareqmy/tap to trust it, and then run brew install gitwig again.

Via Shell Script (macOS / Linux)

For a quick installation, run the following command in your terminal:

curl -fsSL https://raw.githubusercontent.com/tareqmy/gitwig/master/scripts/install.sh | sh

On Windows

You can install Gitwig on Windows via PowerShell:

Run the following command in PowerShell:

irm https://raw.githubusercontent.com/tareqmy/gitwig/master/scripts/install.ps1 | iex

• Benefits: Quick command-line installation to your user profile directory (%USERPROFILE%\.gitwig\bin) without requiring administrator privileges.
• Updating: Supports the in-app self-updater, which will automatically run install.ps1 to download newer versions.

Via Chocolatey (Windows)

You can install Gitwig using Chocolatey:

choco install gitwig

Note: For the in-app self-updater, if installed via Chocolatey, you should update the package by running choco upgrade gitwig.

Via Cargo

You can install Gitwig directly from crates.io:

cargo install gitwig

Via Nix (flake)

The repository ships a Nix flake building both the gitwig and gtg binaries. Run it directly without installing:

nix run github:tareqmy/gitwig

Or install it into your profile:

nix profile install github:tareqmy/gitwig

In a flake-based NixOS / home-manager configuration, add the flake as an input and reference its package:

inputs.gitwig.url = "github:tareqmy/gitwig";
# ...
environment.systemPackages = [ inputs.gitwig.packages.${pkgs.system}.default ];

A development shell with the Rust toolchain is also provided: nix develop.

Note: the in-app self-updater does not apply to Nix installs; update by bumping the flake input (nix flake update gitwig) or re-running nix profile upgrade.

Building from Source

Alternatively, you can clone the repository and build it from source:

git clone https://github.com/tareqmy/gitwig.git
cd gitwig
cargo build --release

The compiled binary will be located at target/release/gitwig. You can copy it to a directory in your $PATH or run it directly.

Uninstalling

If you installed Gitwig via the shell script, you can uninstall it at any time using:

curl -fsSL https://raw.githubusercontent.com/tareqmy/gitwig/master/scripts/uninstall.sh | sh

If you installed Gitwig via the PowerShell script, you can uninstall it at any time using:

irm https://raw.githubusercontent.com/tareqmy/gitwig/master/scripts/uninstall.ps1 | iex

Running

You can launch Gitwig using either the full name or the short command alias gtg:

# Run with default config resolution
gitwig
# Or using the shortcut:
gtg

# Run with an explicit config path
gitwig path/to/config.toml
# Or:
gtg path/to/config.toml

This site is open source. Improve this page.