AwesomeREA.org

Integration

Mizuchi

Plugin pipeline for matching decompilation that loops over functions in an existing decomp project: m2c drafts C, decomp-permuter mutates it, Claude rewrites it through a compile-and-diff tool, and objdiff accepts a result only when the compiled object matches the target assembly. A local Decomp Atlas web app indexes matched and unmatched functions with call graphs and code embeddings, helps pick the next function and builds prompts, while HTML reports summarise each run. An optional integrator places matched C into a git worktree, checks the build and can commit, push or open a PR.

Requirements and limitations

  • The reviewed main commit of 2026-08-17 declares package version 0.1.0; the repository has no releases or tags and is installed from source with npm on Node.js 22+. m2c and decomp-permuter are optional git submodules with setup scripts. Code embeddings need Python 3.10+ and download torch, transformers and an embedding model of about 2–3 GB, using Apple-Silicon MPS or the CPU; --skip-embeddings avoids them.
  • The Claude phase runs through the Claude Agent SDK and needs ANTHROPIC_API_KEY or cached Claude Code credentials; responses are cached locally by prompt hash. The example configuration allows 25 retries per prompt, gives the model read-only codebase tools plus compile_and_view_assembly, and accepts code only at zero instruction differences.
  • Mizuchi works inside a decompilation project the user already has, configured with a map file, non-matching assembly folders, a compiler shell script and the project’s period compiler. It supplies no ROMs, game assets or decompiled game code; the original files come from that project and the user’s own copies. Listed target settings include GBA, DS, 3DS, N64, GameCube, Wii, PlayStation 1/2, PSP, Switch, Saturn, Dreamcast, Win32, Android x86 and IRIX.
  • CI on Ubuntu runs type checks, lint, formatting and the Vitest suite and builds the CLI, using bundled agbcc and KMC GCC compiler fixtures; it covers the tool, not decompilation success on any game. The README links an author post on benchmarks, and the repository publishes no match results; this collection ran nothing. The integrator can push branches and open PRs with gh, and its optional AI build fix lets Claude edit files and run shell commands in the worktree, so review its output before it reaches a shared project.
  • MIT-licensed. m2c, decomp-permuter, objdiff, the embedding model and the compilers keep their own terms, and decompiled code inherits the target project’s rights and contribution rules. The reviewed sources establish no REA connection.

About this entry

Type
Integration
Category
Independent agent workflows
Relationship
Independent agent integration
Targets
Binary · Game

Sources reviewed

The description was reviewed against primary sources. This does not establish runtime testing, security auditing or verified compatibility.

Primary sources

  1. README.md GitHub · macabeus/mizuchi · Revision 25eaef4
  2. mizuchi.example.yaml GitHub · macabeus/mizuchi · Revision 25eaef4
  3. docs/integrator-plugin.md GitHub · macabeus/mizuchi · Revision 25eaef4
  4. package.json GitHub · macabeus/mizuchi · Revision 25eaef4
  5. .gitmodules GitHub · macabeus/mizuchi · Revision 25eaef4
  6. .github/workflows/ci.yml GitHub · macabeus/mizuchi · Revision 25eaef4
  7. LICENSE GitHub · macabeus/mizuchi · Revision 25eaef4