GhAIdra - Assistente IA para Ghidra
APiTJLillo/GhAIdra
Análise de código binário e engenharia reversa assistidas por IA
Ver no GitHubPlugin para Ghidra que integra múltiplos provedores de IA (Azure OpenAI, DeepSeek, Anthropic Claude, Ollama) para análise assistida de funções em binários. Oferece análise de comportamento, renomeação inteligente de funções/variáveis e simulação de PCODE com sugestões alimentadas por IA.
Instalação
npx convez-ai APiTJLillo/GhAIdra1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Análise automatizada de funções em binários com explicações detalhadas
- Renomeação inteligente em lote de funções e variáveis
- Simulação de PCODE com contexto aplicação-específico
- Documentação automática de código descompilado
Veredito

Plugin robusto e maduro para engenharia reversa assistida por IA em Ghidra. Suporta múltiplos provedores LLM com configuração flexível, ideal para profissionais de segurança e análise de malware que desejam agilizar o processo de reversão de binários.
README
A tradução para o português deste README ainda está na fila.
Azure AI Assistant Plugin for Ghidra
A Ghidra plugin that uses Azure OpenAI services to analyze and improve function understanding.
Features
Core Features
- Function Analysis: Get detailed explanations of function behavior and purpose
- Smart Renaming: Get AI-powered suggestions for function and variable names
- PCODE Simulation: Advanced function simulation with AI-powered input suggestions
- Persistent Settings: Analysis options and configurations persist across sessions
Analysis Features
- Multiple Model Support:
- Azure OpenAI
- Azure DeepSeek
- Anthropic
- Ollama
- Recursive Analysis: Option to analyze called functions recursively
- Similar Function Handling: Auto-rename similar functions when found
- Progress Tracking: Visual feedback for long-running operations
- Operation Control: Stop button for canceling operations in progress
- Batch Processing: Analyze or rename multiple functions at once
UI Improvements
- Side-by-side Analysis View:
- Analysis options panel on the left
- Output display on the right
- Progress tracking with visual indicators
- Tabbed Interface:
- Analysis tab for LLM-based analysis
- Simulation tab for PCODE execution
- Easy switching between modes
- Progress Feedback:
- Progress bar for batch operations
- Detailed status updates
- Clear operation state indicators
Project Context Features
- Define application-specific context for more accurate analysis:
- Technology stack and frameworks
- Architecture patterns
- Common code patterns
- Domain-specific terminology
- Context-aware analysis:
- Uses project context for better understanding
- Shows function relationships
- Identifies pattern matches
Operation Controls
- Operation State Management:
- Clear status indicators
- Operation progress tracking
- Batch operation support
- Operation cancellation via stop button
- Configuration Options:
- Model selection
- Temperature and token settings
- Analysis depth control
- Simulation parameters
- Persistent analysis options
Prerequisites
- Ghidra 11.2.1 or later
- Java Development Kit (JDK) 17 or later
- Azure OpenAI Service access with API key
Building
- Set your Ghidra installation directory:
export GHIDRA_INSTALL_DIR=/path/to/ghidra_11.2.1
- Build the plugin:
./gradlew distributeExtension
This will create: dist/ghidra_11.2.1_PUBLIC_YYYYMMDD_ghidra-azure-plugin.zip
Installation
- Open Ghidra
- File -> Install Extensions
- Press the "+" button
- Navigate to the built zip file in the dist directory and select it
- Restart Ghidra
Configuration
-
Go to Window > Azure AI Assistant
-
Click "Configure LLM" button
-
Add and configure your providers:
For Azure OpenAI and Anthropic providers:
- Endpoint URL format:
https://{resource-name}.openai.azure.com/openai/deployments/{deployment-name}- Example:
https://your-resource.openai.azure.com/openai/deployments/gpt-4o - Do NOT include
/chat/completionsor?api-version=parameters
- Example:
- API Key: Your Azure OpenAI or Anthropic API key (header should be "api-key")
- Configure model names and other settings in the dialog
- Endpoint URL format:
Usage
Basic Operations
- Open a program in Ghidra
- Go to Window > Azure AI Assistant
- Position your cursor within a function
- Choose an operation:
- Analyze Function: Get detailed analysis
- Analyze All Functions: Process entire program
- Rename Function: Get name suggestions
- Rename Function & Variables: Full rename suggestions
- Simulate Function: Run PCODE simulation
Configuration Options
- Analysis Settings:
- Enable Recursive Analysis
- Enable Recursive Renaming
- Auto-rename Similar Functions
- Set Analysis Depth
- Project Context:
- Project Name/Type
- Technology Stack
- Architecture Patterns
- Domain Terms
- Code Patterns
Example Project Context Setup
Project Description:
Modern game client application
Uses Gamebryo engine and LuaPlus
Event-driven architecture with custom networking
Common Patterns:
- Event handler registration
- Network packet processing
- UI widget initialization
- Resource management
Domain Terms:
- Gamebryo: 3D game engine
- LuaPlus: Scripting system
- PacketHandler: Network message processor
Contextual Hints:
- Network packets use custom headers
- UI follows MVC pattern
- Resources loaded asynchronously
Simulation Usage
- Switch to Simulation tab
- Select a function to simulate
- Configure simulation parameters:
- Maximum instructions to execute
- Enable/disable execution trace
- Configure register state capture
- Set memory capture options
- Adjust memory capture size
- Use AI-powered input suggestion:
- Click "Suggest Inputs" to get AI-generated parameter values
- AI analyzes function code and suggests appropriate test inputs
- Refine suggestions based on previous simulation results
- Run simulation and view detailed results:
- Execution trace with instruction-by-instruction details
- Register state changes throughout execution
- Memory state changes for pointer parameters
- Final return values and output parameters
- Error detection and handling feedback
- Interactive results navigation:
- Switch between execution trace and register states
- View detailed memory dumps for pointer parameters
- Track error states and simulation progress
- Get refined input suggestions for better code coverage
Troubleshooting
Build Issues
If GHIDRA_INSTALL_DIR is not defined:
export GHIDRA_INSTALL_DIR=/path/to/ghidra_11.2.1
# or
GHIDRA_INSTALL_DIR=/path/to/ghidra_11.2.1 ./gradlew distributeExtension
Common Issues
- Authentication Errors (401):
- Verify endpoint URL format
- Check API key
- Validate model deployment
- Test in Postman
- UI Responsiveness:
- Wait for operations to complete
- Use Clear Output to reset
- Process large programs in batches
- Analysis Quality:
- Ensure project context is set
- Configure appropriate model
- Adjust temperature settings
License
Apache License 2.0