Crucible Preview

Documentation

Installing Git

Install system Git 2.39+ for Git workspaces. Local does not require Git.

Why Git?

Git workspaces use your system Git. Crucible does not package, download, or auto-install Git. Local workspaces work without Git.

Supported version

Crucible requires Git 2.39.0 or newer. After installing, return to Crucible and use Check Again — a restart is usually unnecessary.

macOS

  • Install Xcode Command Line Tools: xcode-select --install (provides Apple Git), or
  • Install from git-scm.com, or
  • Use Homebrew: brew install git.

Confirm with git --version in Terminal.

Windows

  • Install Git for Windows from git-scm.com (recommended).
  • Or install via winget install Git.Git when winget is available.

Ensure Git is on your PATH, then confirm with git --version in PowerShell or Command Prompt.

Linux

  • Debian/Ubuntu: sudo apt update && sudo apt install git
  • Fedora: sudo dnf install git
  • Arch: sudo pacman -S git

Confirm with git --version. Prefer distribution packages or the official Git project builds over embedding Git inside Crucible.

After install

In Crucible: Choose Provider → Check Again, or Git Diagnostics / Doctor. If a Git workspace was already open, it stays registered while Git was missing — operations resume after a successful probe.