idalib-cli — CLI nativo para agentes que encapsula o IDA Pro IDALib para análise binária sem estado com saída JSON: desmontagem, descompilação Hex-Rays, CFG, xrefs, strings e processamento de IDB em lote ou paralelo. | 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

Comando	Descrição
`idalib-cli -d <db> meta`	Tipo de arquivo, compilador, bits
`idalib-cli -d <db> processor`	Informações do processador
`idalib-cli -d <db> segments`	Todos os segmentos
`idalib-cli -d <db> segments-by-range -a <ea>`	Segmento que contém um endereço
`idalib-cli -d <db> functions [-u]`	Lista de funções (`-u` = ignorar lib/thunk)
`idalib-cli -d <db> function -a <ea>`	Uma função: CFG, blocos, xrefs
`idalib-cli -d <db> disasm -a <ea> [-n N]`	Desmonta N instruções (padrão 8)
`idalib-cli -d <db> decompile -a <ea> [--all-blocks]`	Pseudo-código Hex-Rays
`idalib-cli -d <db> insn -a <ea>`	Instrução única (+ classificação `group`/`is_call`/`is_ret`)
`idalib-cli -d <db> strings`	Lista de strings
`idalib-cli -d <db> names`	Locais nomeados
`idalib-cli -d <db> xrefs [-a <ea>] [--all] [--from]`	Xrefs para um endereço (padrão) ou a partir dele (`--from`), ou todos
`idalib-cli -d <db> find --text <s>`	Busca ocorrências de texto
`idalib-cli -d <db> find --imm 0x1337`	Busca ocorrências de valor imediato
`idalib-cli -d <db> find --pattern 554889e5`	Busca um padrão de bytes hex
`idalib-cli -d <db> bytes -a <ea> [-n N] [--width byte\|word\|dword\|qword]`	Bytes brutos (hexdump) ou inteiros little-endian
`idalib-cli -d <db> entries`	Pontos de entrada

Comando	Descrição
`idalib-cli -d <db> comments get\|set\|append\|remove -a <ea> [-c "text"]`	Comentários
`idalib-cli -d <db> bookmarks list\|add\|get\|remove -a <ea> [-d "desc"]`	Favoritos
`idalib-cli -d <db> rename -a <ea> -n <name>`	Renomeia uma função / rótulo de dados
`idalib-cli -d <db> set-type -a <ea> -t "int f(int, char *);"`	Aplica uma declaração de tipo C (protótipo de função / tipo de dados)
`idalib-cli -d <db> signatures --make [--only-pat]`	Gera assinaturas FLIRT

Comando	Descrição
`idalib-cli -d <db> batch -- <op> [<op>...]`	Operações sequenciais, IDB aberto uma vez
`idalib-cli parallel -d <list\|glob> [--jobs N] -- <op>`	Uma operação em muitos DBs, subprocesso para cada
`idalib-cli info [--version\|--ida\|--all]`	Versão da ferramenta / IDA, licença

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

Saída de exemplo (decompile)

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

Campo	Descrição
idadir	Diretório de instalação do IDA (padrão: detectado automaticamente)
idb_dir	Onde novos IDBs são criados (padrão: ao lado do binário)
default_db	Usado quando `-d` é omitido
save	Salva o IDB após cada comando (padrão `true`)
auto_analyse	Executa análise automática completa ao criar um IDB (padrão `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

Ref	Propósito	Exemplo
`main`	desenvolvimento mais recente (alvo de merge de `v*_dev`)	—
`v0.9_dev`	branch de desenvolvimento para a ferramenta 0.9.x	trabalho atual
`v0.9_release`	branch estável para a ferramenta 0.9.x (apenas correções)	backports
`v0.9.1` (tag)	ponto de release	release atual

Versão da ferramenta	IDA compatível	idalib-rs
0.9.x	9.1	0.6.1 (fixado em `=0.6.1`)
próxima (`v0.10_*`)	nova versão do IDA	dependência atualizada

idalib-cli

Mais Populares

🚀 Instalação

🎮 Comandos e uso

Banco de dados

Consulta

Edição (persistida no IDB)

Combinação

Passo a passo de cenários

⚙️ Configuração

❓ Perguntas frequentes

📁 Estrutura do projeto

🌿 Versões e branches

📄 Licença