Installation

ProGit is in public beta. There are no pre-built binaries yet — you build from source. This takes about 2 minutes and gives you the current 0.6.0-beta release.

Prerequisites

Tool	Minimum	Notes
Rust	1.75+	Install via rustup.rs
Git	Any	To clone the repo

Optional for AI features: Ollama running locally.

Build from Source

# 1. Clone
git clone https://git.sovereign-society.org/ProGit/progit.git
cd progit

# 2. Build (release, optimised for size)
cargo build --release

# 3. Install to PATH
sudo cp target/release/prog /usr/local/bin/prog

The binary is called prog.

With OS keyring support

To store forge tokens in your system keyring (GNOME Keyring / KWallet) instead of environment variables:

cargo build --release --features keyring-secrets
sudo cp target/release/prog /usr/local/bin/prog

Verify

prog --version

Expected output:

prog 0.6.0-beta

Token configuration (for forge sync)

ProGit reads tokens from environment variables — no credentials stored in config files:

export PROGIT_TOKEN="your-token"   # generic (tried first)
export GITLAB_TOKEN="your-token"   # GitLab / self-hosted
export FORGEJO_TOKEN="your-token"  # Forgejo / Gitea

Add to ~/.bashrc or ~/.zshrc to persist across sessions.

Updating

cd progit
git pull
cargo build --release
sudo cp target/release/prog /usr/local/bin/prog

Troubleshooting

`prog: command not found`

/usr/local/bin isn’t in your PATH:

echo 'export PATH="$PATH:/usr/local/bin"' >> ~/.zshrc
source ~/.zshrc

Build fails with linker errors

Install build essentials:

# Debian / Ubuntu
sudo apt install build-essential pkg-config libssl-dev

# Arch
sudo pacman -S base-devel openssl

# Fedora
sudo dnf install gcc openssl-devel

Rust is out of date

rustup update stable