Skip to main content

Installation

Install CForge on your system.

Quick Install​

Windows (PowerShell)​

irm https://raw.githubusercontent.com/ChaseSunstrom/cforge/master/scripts/install.ps1 | iex

macOS / Linux​

curl -sSL https://raw.githubusercontent.com/ChaseSunstrom/cforge/master/scripts/install.sh | bash

Manual Installation​

From Source​

# Clone the repository
git clone https://github.com/ChaseSunstrom/cforge.git
cd cforge

# Build with CMake
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release

# Install (may require sudo on Linux/macOS)
cmake --install build

From Releases​

  1. Download the latest release from GitHub Releases
  2. Extract the archive
  3. Add the bin directory to your PATH

Prerequisites​

Required​

  • CMake 3.16 or later
  • C++ Compiler with C++17 support:
    • Windows: MSVC (Visual Studio 2019+) or MinGW-w64
    • macOS: Clang (Xcode Command Line Tools)
    • Linux: GCC 8+ or Clang 7+

Optional​

  • vcpkg - For package management (CForge can bootstrap this automatically)
  • Ninja - Faster builds than Make
  • clang-format - For cforge fmt command
  • clang-tidy - For cforge lint command
  • Doxygen - For cforge doc command

Verify Installation​

cforge version

Expected output:

cforge 1.5.0

Shell Completions​

Enable tab completion for your shell:

Bash​

cforge completions bash > ~/.local/share/bash-completion/completions/cforge

Zsh​

cforge completions zsh > ~/.zfunc/_cforge
# Add to .zshrc: fpath+=~/.zfunc

PowerShell​

cforge completions powershell >> $PROFILE

Fish​

cforge completions fish > ~/.config/fish/completions/cforge.fish

Updating CForge​

Using Install Script​

Run the install script again to update:

# Linux/macOS
curl -sSL https://raw.githubusercontent.com/ChaseSunstrom/cforge/master/scripts/install.sh | bash

# Windows
irm https://raw.githubusercontent.com/ChaseSunstrom/cforge/master/scripts/install.ps1 | iex

From Source​

cd cforge
git pull
cmake --build build --config Release
cmake --install build

Uninstalling​

Linux/macOS​

rm -rf /usr/local/bin/cforge
rm -rf ~/.cforge

Windows​

# Remove from PATH
Remove-Item "$env:LOCALAPPDATA\cforge" -Recurse -Force

Troubleshooting​

If installation fails:

  1. Ensure CMake is installed: cmake --version
  2. Ensure a C++ compiler is available: g++ --version or cl
  3. Check Troubleshooting for common issues
  4. File an issue on GitHub