RE-first · local-first · terminal-native

Bring a hammer to reverse engineering work.

RecompHamr is a lightweight terminal coding agent built for reverse engineering, decompilation, static recompilation, and unfamiliar native-code projects. It keeps local LLM workflows practical while still supporting OpenAI-compatible endpoints.

Ghidra MCP N64 / Xbox / PS workflows AMD-priority profiles Persistent project memory
Evidence-firstNo pretending when checks fail.
Sandbox-awareDesigned for devcontainers and VMs.
Skill-backedRE methods load only when needed.
MCP-readyExpose debugger and RE tools on demand.

Why it exists

Built for native codebases that do not explain themselves.

RecompHamr extends CodeHAMR with reverse-engineering specific skills, MCP integration, project handoff docs, and a system prompt tuned for codebases where symbols, docs, and build history may be incomplete.

01

Reverse-engineering skills

Load methodology for N64, PS2, PS3, Xbox, Xbox 360, SNES, Game Boy, Windows, and PC recompilation work.

02

Tool-gated MCP

Connect Ghidra, emulator debuggers, object diffing, recomp tooling, and more without flooding the model context.

03

Local model profiles

Seed AMD-priority local profiles for LM Studio, Ollama, llama.cpp/Vulkan, or any compatible endpoint.

04

Project memory

Persist reverse-engineering state in .rehamr/REPHAMR_STATE.md so the next session starts with context.

Suggested flow

Audit, trace, verify, then patch.

Use RecompHamr for projects where the safest path is measured progress, not guesswork.

1

Initialize the workspace

Run /init-re to create project state and capture assumptions before the agent starts modifying files.

2

Load only the right skills

Use /skills and /skill <name> so the prompt contains the methodology for your target platform.

3

Connect MCP when useful

Bring in Ghidra, emulator bridges, pcrecomp, objdiff, PCSX2, RPCS3, BizHawk, or other tools as needed.

4

Verify the environment

Run /doctor to check models, GPU drivers, toolchains, MCP status, endpoints, and workspace health.

Terminal demo

Lightweight enough to stay close to the repo.

Keep the workflow terminal-first: inspect files, generate focused patches, package reference repos, and record verified state without switching into a heavy IDE plugin stack.

Open the repo demo GIF →
Animated terminal demo of RecompHamr

Install

Build from source or install with Go.

Requires Go and git. Run RecompHamr inside the project you want it to help analyze.

Go install

go install github.com/DohmBoy64Bit/recomphamr/cmd/recomphamr@latest

Build from source

git clone https://github.com/DohmBoy64Bit/RecompHamr.git
cd RecompHamr
go build -o recomphamr ./cmd/recomphamr/
Run agents safely. Model-generated shell commands can access your filesystem. Use a devcontainer, VM, or disposable workspace for risky targets.

Docs map

Jump straight to the pieces you will use most.

Ready for a hard target?

Start with a workspace. Keep every claim verified.

Open a project, run recomphamr, initialize RE state, load the right skill, and let the agent work close to the evidence.