# Rikugan

> IDA Pro and Binary Ninja plugin that runs its own agent loop inside the disassembler: a model the user chooses streams its answers and calls more than 60 in-process tools for navigation, decompilation, disassembly, cross-references, strings, types, annotations, scripting and host IL or microcode edits. An orchestrator can map a binary and spawn parallel subagents, findings persist in a RIKUGAN.md file beside the database, and experimental commands apply plain-language patches or, on Binary Ninja, remove control-flow flattening and other obfuscation. README says it was vibecoded with Claude Code.

- Type: Integration
- Targets: Binary
- Category: Independent agent workflows
- Relationship: Independent agent integration
- Sources reviewed: 2026-10-19
- Added to the catalog: 2026-11-02
- Original resource: <https://github.com/buzzer-re/Rikugan>
- Primary source: <https://github.com/buzzer-re/Rikugan/blob/a2ba6691baa0a7ace3bce9fe834a4f6f7610b77d/README.md>
- Catalog page: <https://awesomerea.org/resources/rikugan/>
- Record JSON: <https://awesomerea.org/resources/rikugan/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/rikugan/index.md)

## Requirements & limits

- **Prerequisites:** README requires IDA Pro 9.0+ with the Hex-Rays decompiler or Binary Ninja in UI mode, and Python 3.10+, while pyproject.toml asks for 3.11+; ida-plugin.json lists IDA 9.0 to 9.2 on Windows, Linux and macOS. Windows also needs the latest Visual C++ 2015–2022 x64 redistributable, and the install scripts are piped from raw GitHub.
- **Prerequisites:** Needs at least one model provider: Anthropic, OpenAI, Gemini, MiniMax, Codex, local Ollama or any OpenAI-compatible endpoint. Tool results from the open database go to the chosen provider; profiles limit which data the model may read and which tools it may use.
- **Limits:** Version 1.4.0 (released 2026-09-25) at review. README says the agent asks permission before running scripts and never executes the target binary; natural-language patching (/modify) and the Binary Ninja /deobfuscation skill are marked experimental.
- **Testing evidence:** CI runs Ruff format and lint checks, mypy on the core and provider modules, pytest with an IDA mock and a desloppify score-regression gate. The repository publishes no benchmark; a Synacktiv article of 2026-10-13 compared it with another Binary Ninja agent on two CREBench tasks and attributed most of the gap to a prompt difference.
- **License:** MIT per LICENSE and both plugin manifests; IDA Pro, Hex-Rays, Binary Ninja and model services keep their own licences and terms.
- **Attribution:** README calls the project a work in progress whose first version was built in a single night, and the repository carries an AGENTS.md developer guide.

## Primary sources

1. <https://github.com/buzzer-re/Rikugan/blob/a2ba6691baa0a7ace3bce9fe834a4f6f7610b77d/README.md>
2. <https://github.com/buzzer-re/Rikugan/blob/a2ba6691baa0a7ace3bce9fe834a4f6f7610b77d/LICENSE>
3. <https://github.com/buzzer-re/Rikugan/blob/a2ba6691baa0a7ace3bce9fe834a4f6f7610b77d/pyproject.toml>
4. <https://github.com/buzzer-re/Rikugan/blob/a2ba6691baa0a7ace3bce9fe834a4f6f7610b77d/ida-plugin.json>
5. <https://github.com/buzzer-re/Rikugan/blob/a2ba6691baa0a7ace3bce9fe834a4f6f7610b77d/plugin.json>
6. <https://github.com/buzzer-re/Rikugan/tree/a2ba6691baa0a7ace3bce9fe834a4f6f7610b77d/rikugan/providers>
7. <https://github.com/buzzer-re/Rikugan/blob/a2ba6691baa0a7ace3bce9fe834a4f6f7610b77d/.github/workflows/ci.yml>
8. <https://github.com/buzzer-re/Rikugan/blob/a2ba6691baa0a7ace3bce9fe834a4f6f7610b77d/.github/workflows/release.yml>
9. <https://github.com/buzzer-re/Rikugan/blob/a2ba6691baa0a7ace3bce9fe834a4f6f7610b77d/AGENTS.md>
10. <https://github.com/buzzer-re/Rikugan/releases/tag/v1.4.0>
11. <https://www.synacktiv.com/en/publications/ufc-666-frontkick-vs-rikugan>

## More in Agents and MCP

- [bn](https://awesomerea.org/resources/bn-binary-ninja-agent-cli/index.md) · Integration
- [IDA Pro MCP Server (fdrechsler)](https://awesomerea.org/resources/mcp-server-idapro-fdrechsler/index.md) · Integration
- [Ghidra Headless MCP](https://awesomerea.org/resources/ghidra-headless-mcp/index.md) · Integration
- [Binary Ninja Headless MCP](https://awesomerea.org/resources/binary-ninja-headless-mcp/index.md) · Integration
- [IDA-Skill](https://awesomerea.org/resources/ida-skill-malware-analysis/index.md) · Integration
- [BinAssist](https://awesomerea.org/resources/binassist/index.md) · Integration

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.