scripting-ghidra-headless-analysis
Automates batch reverse engineering by generating Ghidra analyzeHeadless commands and
v1.0.03 installs+3 in 7 days24 StarsApache-2.0synced 10 hours ago
Install
No NotHoly CLI yet? Install it first.
$ curl -fsSL https://notholy.com/install.sh | sh$ notholy skills install meltedinhex/scripting-ghidra-headless-analysisWrites to ~/.notholy/skills after checking the signature and the SHA-256.
SignatureSigned, ed25519
Packagec5037a7f…faf89ea7
c5037a7f22cd…1c96faf89ea74 files · 3.1 KBScanMedium2 findings
- Executable script shipped with the skillscripts/analyst.py
- Links to outside domains
Sourcegithub.com/meltedinhex/analyst-ai-pack/tree/main/skills/scripting-ghidra-headless-analysis@da7600a
On this page
When to Use
- You need to auto-analyze many samples (or re-run a consistent analysis) without the Ghidra GUI.
- You want to generate the
analyzeHeadlesscommand and a post-script that exports functions, strings, or decompiled output.
Do not use this to run untrusted samples — Ghidra analyzes binaries statically and never executes them, but keep the import directory isolated. This skill prepares automation, it does not run the binary.
Prerequisites
- A Ghidra installation (
analyzeHeadlessinsupport/) and the samples to import.
Safety & Handling
- Ghidra does not execute the sample; still store imports in an isolated, defanged directory.
Workflow
Step 1: Generate the headless command
python scripts/analyst.py command --project /proj --name Batch --import ./samples --script export.pyBuilds an analyzeHeadless invocation with project path, import directory, post-script, and common
flags (-recursive, -overwrite, -deleteProject optional).
Step 2: Generate a post-analysis script skeleton
python scripts/analyst.py postscript --out export.py --emit functions,stringsEmits a Ghidra Python (Jython) script that iterates functions/strings and writes JSON next to the program.
Step 3: Run and collect
Execute the generated command, then aggregate the per-sample JSON exports.
Step 4: Review
Spot-check a few exports to confirm analysis completeness before scaling up.
Validation
- The generated command references a valid project path, import dir, and existing post-script.
- The post-script uses real Ghidra API calls (
currentProgram,getFunctionManager). - Output JSON is produced per imported program.
Pitfalls
- Forgetting
-overwrite/-recursive, causing skipped or duplicate imports. - Jython 2 syntax constraints in post-scripts (no f-strings).
- Project lock conflicts when running multiple headless jobs on one project.
References
- See
references/api-reference.mdfor the generator. - Ghidra analyzeHeadless and API docs (linked in frontmatter).
Files in this version
references/11.2 KB
- api-reference.md1.2 KB
scripts/13.6 KB
- analyst.py3.6 KB
- LICENSE340 B
- SKILL.md2.9 KB
Permissions
| Permission | Declared | Found by the scan |
|---|---|---|
| Reads files | No | No |
| Writes files | Yes | Yes |
| Runs shell commands | Yes | Yes |
| Uses the network | Yes | Yes |
| Uses connectors | No | No |
| Drives a browser | No | No |
Scan findings
Reviewed on Nov 13, 2026
- MediumFile · Executable script shipped with the skillscripts/analyst.py
- InfoLink · Links to outside domains
A clean scan lowers the risk but does not prove a package is safe. Read what you install.
| Version | Published | Commit | SHA-256 | Signature | Permission change |
|---|---|---|---|---|---|
| v1.0.0 | Nov 13, 2026 | da7600a | c5037a7f | Signed | – |
More from meltedinhex
All from this publisher- writing-yara-rules-from-reversed-codemeltedinhex/writing-yara-rules-from-reversed-code4
- validating-detections-with-atomic-testsmeltedinhex/validating-detections-with-atomic-tests4
- writing-suricata-and-snort-rulesmeltedinhex/writing-suricata-and-snort-rules3
- writing-sigma-detection-rulesmeltedinhex/writing-sigma-detection-rules3
More in Reverse engineering and fuzzing
See the categoryAsk anything your scope allows.
Create an account, add credits and ask the first question in the chat or the terminal.
- 1/3
Create the account
Individual or company. You can switch to a company later without losing balance or keys.
IndividualCompany - 2/3
Add credits
By card. Pay per token, no subscription.
$5.00minimum deposit - 3/3
Ask
In the chat, or install the CLI and run notholy login in your terminal.
$ notholy login