idalib-cli — واجهة سطر أوامر أصلية للوكيل تغلّف IDA Pro IDALib لتحليل ثنائي عديم الحالة بمخرجات JSON: التفكيك، وفك الترجمة Hex-Rays، وCFG، والمراجع المتقاطعة، والسلاسل النصية، ومعالجة IDB على دفعات أو بالتوازي. | Kitploit

export IDADIR="/Applications/IDA Professional 9.1.app/Contents/MacOS"  # IDA install dir
export IDASDKDIR=/path/to/idasdk91                                     # unpacked SDK (absolute path!)

git clone <this-repo> && cd idalib-cli
cargo install --path .

idalib-cli info    # ✅ verify tool version, IDA version, license

الأمر	الوصف
`idalib-cli -d <db> meta`	نوع الملف، المترجم، عدد البتات
`idalib-cli -d <db> processor`	معلومات المعالج
`idalib-cli -d <db> segments`	جميع المقاطع
`idalib-cli -d <db> segments-by-range -a <ea>`	المقطع الذي يحتوي على عنوان
`idalib-cli -d <db> functions [-u]`	قائمة الدوال (`-u` = تخطي المكتبات/thunk)
`idalib-cli -d <db> function -a <ea>`	دالة واحدة: CFG، الكتل، المراجع المتقاطعة
`idalib-cli -d <db> disasm -a <ea> [-n N]`	فك N تعليمة (الافتراضي 8)
`idalib-cli -d <db> decompile -a <ea> [--all-blocks]`	شيفرة Hex-Rays الزائفة
`idalib-cli -d <db> insn -a <ea>`	تعليمة واحدة (+ تصنيف `group`/`is_call`/`is_ret`)
`idalib-cli -d <db> strings`	قائمة النصوص
`idalib-cli -d <db> names`	المواقع المُسمّاة
`idalib-cli -d <db> xrefs [-a <ea>] [--all] [--from]`	المراجع المتقاطعة إلى عنوان (افتراضي) أو منه (`--from`)، أو الكل
`idalib-cli -d <db> find --text <s>`	البحث عن مطابقات نصية
`idalib-cli -d <db> find --imm 0x1337`	البحث عن مطابقات قيمة فورية
`idalib-cli -d <db> find --pattern 554889e5`	البحث عن نمط بايتات سداسي
`idalib-cli -d <db> bytes -a <ea> [-n N] [--width byte\|word\|dword\|qword]`	بايتات خام (hexdump) أو أعداد صحيحة little-endian
`idalib-cli -d <db> entries`	نقاط الدخول

الأمر	الوصف
`idalib-cli -d <db> comments get\|set\|append\|remove -a <ea> [-c "text"]`	التعليقات
`idalib-cli -d <db> bookmarks list\|add\|get\|remove -a <ea> [-d "desc"]`	العلامات المرجعية
`idalib-cli -d <db> rename -a <ea> -n <name>`	إعادة تسمية دالة / تسمية بيانات
`idalib-cli -d <db> set-type -a <ea> -t "int f(int, char *);"`	تطبيق تعريف نوع C (نموذج دالة / نوع بيانات)
`idalib-cli -d <db> signatures --make [--only-pat]`	توليد توقيعات FLIRT

الأمر	الوصف
`idalib-cli -d <db> batch -- <op> [<op>...]`	عمليات متسلسلة، يُفتح IDB مرة واحدة
`idalib-cli parallel -d <list\|glob> [--jobs N] -- <op>`	عملية واحدة عبر قواعد بيانات كثيرة، عملية فرعية لكل واحدة
`idalib-cli info [--version\|--ida\|--all]`	إصدار الأداة / IDA، الترخيص

idalib-cli -d ./sample meta            # what is it? (filetype/compiler/bitness)
idalib-cli -d ./sample segments        # memory layout
idalib-cli -d ./sample strings         # quick hints
idalib-cli -d ./sample functions -u    # user code only

idalib-cli -d ./sample function -a 0x401000       # CFG + blocks + xrefs
idalib-cli -d ./sample decompile -a 0x401000      # read the pseudo-code
idalib-cli -d ./sample disasm -a 0x401000 -n 20   # or the raw instructions
idalib-cli -d ./sample xrefs -a 0x401000 --all    # who calls it

idalib-cli -d ./sample comments set -a 0x401000 -c "parses config, see 0x402100"
idalib-cli -d ./sample bookmarks add -a 0x401000 -d "entry point"
idalib-cli -d ./sample comments get -a 0x401000    # verify

# first pass: create IDBs + overview for every sample
idalib-cli parallel -d "./samples/*.bin" -- "batch -- meta functions -u"

# deep pass: decompile one hot function in every IDB
idalib-cli parallel -d "./samples/*.i64" --jobs 8 -- "decompile -a 0x401000"

idalib-cli -d ./sample find --text "MAGIC"            # string hits
idalib-cli -d ./sample find --imm 0x1337              # immediate-value hits
idalib-cli -d ./sample find --pattern 554889e5        # byte pattern (prologue)
idalib-cli -d ./sample bytes -a 0x401000 -n 32        # hexdump
idalib-cli -d ./sample bytes -a 0x401000 --width qword -n 4
idalib-cli -d ./sample xrefs -a 0x401000 --from       # outgoing refs (calls)
idalib-cli -d ./sample rename -a 0x401000 -n decrypt  # label it
idalib-cli -d ./sample set-type -a 0x401000 -t "int f(const char *, int);"  # set prototype

مثال مخرجات (decompile)

{
  "id": 7,
  "start": "0x401000",
  "end": "0x401080",
  "size": 128,
  "name": "main",
  "blocks": 3,
  "decompiled": true,
  "pseudocode": "int __cdecl main(...) { ... }"
}

الحقل	الوصف
idadir	مجلد تثبيت IDA (الافتراضي: يُكتشف تلقائيًا)
idb_dir	مكان إنشاء ملفات IDB الجديدة (الافتراضي: بجانب الملف الثنائي)
default_db	يُستخدم عند حذف `-d`
save	حفظ IDB بعد كل أمر (الافتراضي `true`)
auto_analyse	تشغيل التحليل التلقائي الكامل عند إنشاء IDB (الافتراضي `true`)

idalib-cli/
├── src/
│   ├── cli.rs            # clap definitions; every command + -d/--db
│   ├── ops/              # metadata, comments, bookmarks, db, batch, parallel, ...
│   ├── session/          # config.toml handling
│   └── helpers/          # JSON output views
├── stubs/idalib/         # dev-only API stub (SDK-free checks, never shipped)
├── tests/                # integration tests
├── skills/idalib-cli/   # single agent skill (workflow guide)
└── examples/workflow.sh  # runnable end-to-end example

المرجع	الغرض	مثال
`main`	أحدث تطوير (هدف دمج `v*_dev`)	—
`v0.9_dev`	فرع التطوير للأداة 0.9.x	العمل الحالي
`v0.9_release`	فرع مستقر للأداة 0.9.x (إصلاحات فقط)	backports
`v0.9.1` (tag)	نقطة الإصدار	الإصدار الحالي

إصدار الأداة	IDA المتوافق	idalib-rs
0.9.x	9.1	0.6.1 (مثبّت `=0.6.1`)
التالي (`v0.10_*`)	إصدار IDA جديد	تبعية محدّثة

idalib-cli

الأكثر شعبية

🚀 التثبيت

🎮 الأوامر والاستخدام

قاعدة البيانات

الاستعلام

التحرير (يُحفظ في IDB)

الدمج

جولات سيناريوهات

⚙️ الإعدادات

❓ الأسئلة الشائعة

📁 بنية المشروع

🌿 الإصدارات والفروع

📄 الترخيص