Installation

Standalone Installers (Recommended)

Fastest way to install pre-compiled, release-optimized binaries on Linux, macOS, or Windows.

Linux / macOS (Shell Script)

curl -fsSL https://raw.githubusercontent.com/JashT14/symtrace/main/install.sh | bash

Windows (PowerShell Script)

iwr -useb https://raw.githubusercontent.com/JashT14/symtrace/main/install.ps1 | iex

---

Package Managers

macOS (Homebrew)

brew tap JashT14/symtrace
brew install symtrace

Windows (WinGet / Scoop)

# WinGet
winget install SymTrace.SymTrace

# Scoop
scoop bucket add symtrace https://github.com/JashT14/scoop-symtrace
scoop install symtrace

Linux Packages (.deb / .rpm)

# Debian / Ubuntu (.deb)
wget https://github.com/JashT14/symtrace/releases/download/v0.3.0/symtrace_0.3.0_amd64.deb
sudo dpkg -i symtrace_0.3.0_amd64.deb

# Fedora / RHEL / CentOS (.rpm)
sudo rpm -i https://github.com/JashT14/symtrace/releases/download/v0.3.0/symtrace-0.3.0-1.x86_64.rpm

Cargo (Pre-built Binary / Source)

# Fast pre-built binary installation
cargo binstall symtrace

# Direct build from source via Cargo
cargo install symtrace

---

Build from Source

Prerequisites

• Rust (toolchain edition 2021+)
• A C compiler (gcc, clang, or MSVC) for libgit2 and tree-sitter native bindings

Clone & Build

git clone https://github.com/JashT14/symtrace.git
cd symtrace

# Production release build
cargo build --release

Binary location: target/release/symtrace (.exe on Windows).

Production Build Scripts

Runs clean, formatting, clippy linting (warnings-as-errors), full test suite (166 tests), and release build:

./build.sh production          # macOS / Linux
.\build.ps1 -Target production # Windows
make production                # GNU Make

Verify Installation

symtrace --version