ida-docs

Agent skill for IDA 9.x IDAPython lookup, backed by the public Hex-Rays IDA SDK. This is not an official Hex-Rays project.

Use as a skill

Load skills/ida-docs/ for IDAPython 9.x work.

What this provides

• SDK-backed IDAPython lookup workflow for agents.
• Curated high-frequency IDA 9.x traps and quick references.
• Bundled copy of the official IDAPython 8.x to 9.0 porting guide.
• Focused guides for type work and main-thread execution.

Skill layout

skills/ida-docs/
├── SKILL.md
├── assets/
│   └── .gitkeep
├── references/
│   ├── ida-type-work.md
│   ├── idapython-porting-guide-ida-9.md
│   └── main-thread-and-execute-sync.md
└── scripts/
    ├── setup-sdk.sh
    └── setup_sdk.py

SDK setup

skills/ida-docs/scripts/setup-sdk.sh manages the local clone of the official IDA SDK and tracks published stable releases. The skill runs ensure before its first SDK lookup in each session.

• skills/ida-docs/scripts/setup-sdk.sh ensure - initialize the clone if absent and check for a newer release; successful checks are cached for 24 hours.
• skills/ida-docs/scripts/setup-sdk.sh init - clone the latest release.
• skills/ida-docs/scripts/setup-sdk.sh status - show the local SDK version without accessing the network.
• skills/ida-docs/scripts/setup-sdk.sh check - compare the local clone with the latest release.
• skills/ida-docs/scripts/setup-sdk.sh update - update to the latest release; refuses a clone with local changes.

Notes:

• Requires Python 3.12+ and the git CLI.
• Runtime state lives under skills/ida-docs/assets/: ida-sdk/ is the clone and .ida-sdk-last-check records the last successful check; both are gitignored.
• Only update changes an existing clone.

Tests

• uv run ruff format --check .
• uv run ruff check .
• uv run pytest