Skip to content

Installation

Ryan Cole edited this page Nov 15, 2026 · 2 revisions

There are no prebuilt releases yet: build from source. Everything below runs on Windows; pbeta and pbeta-mcp also build and test on Linux (CI runs both), but the hook host and the programs it hooks are Windows only (x64 or x86).

Requirements

For Needs
pbeta, pbeta-mcp Stable Rust (rustup.rs). The repo's rust-toolchain.toml selects it, with rustfmt and clippy.
Hook host Visual Studio's C++ x64 toolset (MSVC), and the x86 one for 32-bit programs; git and PowerShell 7 (pwsh). Microsoft Detours is fetched at a pinned commit.
Replay by emulation (optional) CMake, Ninja and libclang, for the emulator feature.
Ghidra integration (optional) Ghidra 12.x, JDK 25+, Gradle 9.1+ (see Ghidra Integration).
IDA plugin (optional) IDA Home or Pro 9.x with IDAPython (see IDA Plugin).
AI proposer (optional) The Claude Code CLI, signed in (see AI Proposer).

Build

git clone https://github.com/ryancole/permanent-beta.git
cd permanent-beta
cargo build --release
pwsh harness/host/build.ps1

This gives:

Path What
target/release/pbeta.exe The CLI
target/release/pbeta-mcp.exe The MCP server
target/host/pbeta-host.dll, target/host/pbeta-launch.exe The hook host and its launcher (keep them together)
target/host/include/pbeta_handler.h Header for writing handler DLLs

For 32-bit programs, build the x86 hook host too: pwsh harness/host/build.ps1 -Arch x86 writes the same files to target/host-x86. pbeta itself handles both architectures.

To put pbeta and pbeta-mcp on your PATH instead:

cargo install --path crates/permanent-beta-cli
cargo install --path crates/permanent-beta-mcp

Replay by emulation

Replaying recorded calls on the new build (Behavioral Evidence) is behind an optional feature, off by default:

cargo build --release --features permanent-beta-replay/emulator

Without it, pbeta replay and repair --cases report every case as inconclusive and say so.

Check the install

target/release/pbeta --version
pwsh harness/host/test.ps1
pwsh harness/host/test.ps1 -Arch x86     # if you built the x86 host

test.ps1 builds a test app twice, has pbeta locate its hooks in both builds and runs them under the hook host in every mode. It takes about a minute (longer the first time, while Detours builds).

Next: Quick Start.

Clone this wiki locally