Repository navigation
Installation
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).
| 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). |
git clone https://github.com/ryancole/permanent-beta.git
cd permanent-beta
cargo build --release
pwsh harness/host/build.ps1This 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-mcpReplaying recorded calls on the new build (Behavioral Evidence) is behind an optional feature, off by default:
cargo build --release --features permanent-beta-replay/emulatorWithout it, pbeta replay and repair --cases report every case as inconclusive and say so.
target/release/pbeta --version
pwsh harness/host/test.ps1
pwsh harness/host/test.ps1 -Arch x86 # if you built the x86 hosttest.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.
Permanent Beta is Apache-2.0. Found something wrong on this page? Open an issue.
Getting started
Using it
Integrations
Project