✨ 기능

• 🗄️ 무상태(Stateless) — -d/--db <PATH> (바이너리 또는 .i64)를 전달하세요. 데몬도, 세션 관리도 없습니다.
• 💾 영구적인 IDB 상태 — IDB 파일이 곧 상태입니다. 주석, 북마크, 이름, 분석 결과가 프로세스 간에 유지됩니다.
• 🧩 완전한 IDALib 지원 — 세그먼트, 함수, CFG, 디스어셈블리, Hex-Rays 디컴파일, 문자열, 이름, xref, 엔트리, 메타데이터, 주석, 북마크, 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 문서이며, 오류는 0이 아닌 종료 코드와 함께 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):

❓ FAQ

📁 프로젝트 구조