> For the complete documentation index, see [llms.txt](https://docs.hex-rays.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hex-rays.com/readme.md).

# Welcome to Hex-Rays docs

## Welcome to IDA docs

Tutorials, concepts, and references to guide you from your first disassembly to using IDA in your agentic workflows.

<a href="/release-notes/9_5.md" class="button primary">Read 9.5 Release Notes</a>

<h2 align="center">Getting Started</h2>

New to IDA? Go through the installation and kickstart your reverse engineering journey.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>Install IDA</strong></td><td>Get your IDA instance up and running on your local machine</td><td><a href="/getting-started/install-ida.md">IDA Installation</a></td><td><a href="https://492083732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFP6ibt8r6WPBHTqekG9u%2Fuploads%2Fgit-blob-8e0685657a8b6a77aa0c202421d66c00ace61d35%2Finstall%20IDA.jpg?alt=media">install IDA.jpg</a></td></tr><tr><td><strong>Activate your license</strong></td><td>Check how to activate your licenses and share them with your team members</td><td><a href="/getting-started/licensing.md">License Activation</a></td><td><a href="https://492083732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFP6ibt8r6WPBHTqekG9u%2Fuploads%2Fgit-blob-948938fac30cc3902b46d58242561ce96b1f5d41%2FActivate%20license.jpg?alt=media">Activate license.jpg</a></td></tr><tr><td><strong>Check basic features</strong></td><td>Reverse your first binary file and discover the capabilities of disassembly and decompilation</td><td><a href="/getting-started/basic-usage.md">Basic Usage</a></td><td><a href="https://492083732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFP6ibt8r6WPBHTqekG9u%2Fuploads%2Fgit-blob-3c7c0f3fb0f1f4a7a83cec4b455ade2d93802b84%2FCheck%20basic%20feature.jpg?alt=media">Check basic feature.jpg</a></td></tr></tbody></table>

<h2 align="center">Core analysis features</h2>

Find call paths, trace cross-references, and jump anywhere in the database, fast.

<table data-card-wrap="false" data-view="cards"><thead><tr><th></th><th></th><th><select><option value="meH5huXffPHB" label="START HERE" color="blue"></option><option value="qT9pXvNa2LmK" label="GO DEEPER" color="purple"></option></select></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3>Essentials</h3></td><td>Main UI components and navigation around IDA</td><td><span data-option="meH5huXffPHB">START HERE</span></td><td><ul><li><a href="/core/user-interface/concepts/subviews.md">Subviews</a></li><li><a href="/core/user-interface/concepts/jump-anywhere.md">Jump Anywhere</a></li><li><a href="/core/user-interface/how-tos/using-deep-links.md">Deep Links</a></li><li><a href="/core/types/how-tos/working-with-types.md">Working with Types</a></li></ul></td><td></td><td><a href="/core/user-interface/overview.md">Overview</a></td></tr><tr><td><h3>Disassembler</h3></td><td>Human-readable assembly code</td><td><span data-option="qT9pXvNa2LmK">GO DEEPER</span></td><td><ul><li><a href="/core/disassembler/concepts/loaders.md">Loaders</a></li><li><a href="/core/disassembler/concepts/pathfinder.md">Pathfinder</a></li><li><a href="/core/disassembler/concepts/xref-graph.md">Xref Graph</a></li></ul></td><td></td><td><a href="/core/disassembler.md">Disassembler</a></td></tr><tr><td><h3>Decompiler</h3></td><td>Pseudocode and microcode to power up your analysis</td><td><span data-option="qT9pXvNa2LmK">GO DEEPER</span></td><td><ul><li><a href="/core/decompiler/how-tos/running-in-batch-mode.md">Running in Batch Mode</a></li><li><a href="/core/decompiler/how-tos/microcode-view.md">Working with Microcode</a></li></ul></td><td></td><td><a href="/core/decompiler.md">Decompiler</a></td></tr><tr><td><h3>Debugger</h3></td><td>Local and remote dynamic analysis</td><td><span data-option="qT9pXvNa2LmK">GO DEEPER</span></td><td><ul><li><a href="/core/debugger/tutorials/trace_replayer.md">Trace Replayer</a></li><li><a href="/core/debugger/tutorials/appcall_primer.md">Appcall</a></li></ul></td><td></td><td><a href="/core/debugger.md">Debugger</a></td></tr></tbody></table>

<h2 align="center">Built for AI and automation</h2>

The native tools for automating IDA and connecting it to AI agents: by script, by CI/CD pipeline, or from inside IDA.

<table data-card-wrap="false" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3>idalib</h3></td><td>Run IDA's analysis headlessly, from scripts and pipelines, to integrate IDA into your own toolchain.</td><td></td><td><a href="/core/idalib/overview.md">Overview</a></td></tr><tr><td><h3>Assist</h3></td><td>An AI agent for reverse engineering, built directly into IDA.</td><td></td><td><a href="/add-ons/assist/overview.md">Overview</a></td></tr><tr><td><h3>IDA MCP</h3></td><td>The official Hex-Rays IDA MCP Server lets humans and AI agents collaborate on multiple IDA databases at once.</td><td></td><td><a href="/add-ons/mcp/overview.md">Overview</a></td></tr><tr><td><h3>HCLI</h3></td><td>Modern command-line tool for downloading and installing IDA beyond the GUI: perfect for automated pipelines or Docker environments.</td><td></td><td><a href="https://hcli.docs.hex-rays.com/">https://hcli.docs.hex-rays.com/</a></td></tr><tr><td><h3>Domain API</h3></td><td>Pythonic and agent-friendly API, built on top of IDAPython. Approachable for newcomers, discoverable for agents.</td><td></td><td><a href="/developer/domain-api.md">Domain API</a></td></tr></tbody></table>

<h2 align="center">Teamwork at scale</h2>

Collaborate as a team on the same binary using the Teams add-on or share IDA access across multiple users.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>Floating Licenses</h4></td><td>Manage seats for a whole team, tracked by a central license server</td><td><a href="/add-ons/floating-license/overview.md">Overview</a></td></tr><tr><td><h4>Teams</h4></td><td>Git-native solution for a collaborative analysis on the same database</td><td><a href="/add-ons/teams/overview.md">Overview</a></td></tr><tr><td><h4>Lumina</h4></td><td>Community-sourced function metadata, pulled from Hex-Rays' server or your private one</td><td><a href="/add-ons/lumina.md">Lumina</a></td></tr></tbody></table>

<h2 align="center">What's new in docs?</h2>

Check the [latest updates](/readme/whats-new.md) in the Hex-Rays documentation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hex-rays.com/readme.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.