✨ विशेषताएँ

• 🗄️ स्टेटलेस — -d/--db <PATH> पास करें (एक बाइनरी या एक .i64); कोई डेमन नहीं, कोई सेशन बुककीपिंग नहीं।
• 💾 स्थायी IDB स्थिति — IDB फ़ाइल ही स्थिति है: कमेंट, बुकमार्क, नाम और विश्लेषण प्रक्रियाओं के बीच बने रहते हैं।
• 🧩 पूर्ण IDALib कवरेज — सेगमेंट, फ़ंक्शन, CFG, डिसअसेम्बली, Hex-Rays डीकंपाइलेशन, स्ट्रिंग्स, नाम, xrefs, एंट्रीज़, मेटाडेटा, कमेंट, बुकमार्क, FLIRT सिग्नेचर।
• ⚡ batch और parallel — एक IDB खोलकर कई कमांड चलाएँ; एक कमांड को कई डेटाबेस पर समवर्ती रूप से फैलाएँ (glob समर्थित)।
• 🤖 एजेंट-फ़र्स्ट — stdout पर एक JSON दस्तावेज़, stderr पर त्रुटियाँ; Codex / Claude Code / OpenCode के लिए स्किल्स शामिल।

🚀 इंस्टॉल

पूर्वापेक्षाएँ: IDA Pro 9.1 (लाइसेंस प्राप्त, एक बार लॉन्च किया गया) · IDA 9.1 SDK अनपैक किया गया (केवल बिल्ड समय पर) · Rust + LLVM/Clang (bindgen आवश्यकताएँ)

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

SDK की आवश्यकता केवल बिल्ड समय पर होती है; बाइनरी रनटाइम पर आपकी स्थानीय IDA लाइब्रेरीज़ को लिंक करती है। SDK के बिना देव जाँच: cargo test --no-default-features --features stub-idalib।

🎮 कमांड और उपयोग

हर कमांड को -d/--db <PATH> चाहिए — एक IDB फ़ाइल (.i64) या एक बाइनरी (पहले उपयोग पर इसके बगल में एक IDB बनाया जाता है)। पते 0x401000 या 401000 स्वीकार करते हैं। आउटपुट हमेशा एक JSON दस्तावेज़ होता है; त्रुटियाँ गैर-शून्य एग्ज़िट कोड के साथ stderr पर जाती हैं।

डेटाबेस

क्वेरी

संपादन (IDB में सहेजा गया)

संयोजन

परिदृश्य वॉकथ्रू

🔎 एक अज्ञात बाइनरी का ट्रायाज

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

🤖 एजेंट-अनुकूल बैच्ड निरीक्षण (एक JSON दस्तावेज़)

idalib-cli -d ./sample batch -- "meta" "segments" "functions -u" "decompile -a 0x401000"

एजेंट वर्कफ़्लो गाइड: skills/idalib-cli/SKILL.md; एक चलाने योग्य एंड-टू-एंड उदाहरण examples/workflow.sh में।

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

⚙️ कॉन्फ़िगरेशन

वैकल्पिक ~/.idapro/idalib-cli/config.toml (बेस डिर: $IDALIB_CLI_HOME):

❓ सामान्य प्रश्न