✨ 機能

• 🗄️ ステートレス — -d/--db <PATH>（バイナリまたは .i64）を渡すだけ。デーモンもセッション管理も不要です。
• 💾 永続的な IDB 状態 — IDB ファイルそのものが状態です。コメント、ブックマーク、名前、解析結果はプロセスをまたいで保持されます。
• 🧩 IDALib を完全カバー — セグメント、関数、CFG、逆アセンブル、Hex-Rays 逆コンパイル、文字列、名前、xref、エントリ、メタデータ、コメント、ブックマーク、FLIRT シグネチャ。
• ⚡ batch と parallel — 1 つの IDB を開いたまま多数のコマンドを実行。1 つのコマンドを多数のデータベースへ並行展開（glob 対応）。
• 🤖 エージェントファースト — stdout には 1 つの 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 を受け付けます。出力は常に 1 つの 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

🤖 エージェントフレンドリーな一括検査（1 つの 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

📁 プロジェクト構成