Metadata-Version: 2.4
Name: ida-codemode
Version: 0.2.0
Summary: Code Mode MCP server for the ida-domain API
Requires-Python: >=3.11
Requires-Dist: ida-domain>=0.5.1.dev2
Requires-Dist: ida-hcli
Requires-Dist: idapro
Requires-Dist: zeromcp>=1.5.0
Description-Content-Type: text/markdown

# ida-codemode

⚠️ Experimental prerelease ⚠️

IDA Code Mode gives agents a compact Python execution surface over the
[`ida-domain`](https://github.com/HexRaysSA/ida-domain) API. It will
discover and share databases already open in the IDA GUI, and starts
managed idalib workers only when no suitable instance exists.

## Installation

### Requirements

- Installed in your PATH
  - [Git](https://git-scm.com/)
  - [uv](https://github.com/astral-sh/uv)
- IDA 9.4 or higher with Python 3.11+

### [Claude Code](https://claude.com/product/claude-code)

```bash
claude plugin marketplace add HexRaysSA/claude-marketplace
claude plugin install ida-mcp@HexRaysSA
```

### [Codex CLI](https://learn.chatgpt.com/docs/codex/cli)

```bash
codex plugin marketplace add HexRaysSA/codex-marketplace
codex plugin add ida-mcp@HexRaysSA
```

### [Pi](https://pi.dev/)

```bash
pi install git:github.com/HexRaysSA/ida-codemode
```

### Other agents

Configure a regular stdio MCP server in your `mcp.json`:

```json
{
  "mcpServers": {
    "ida": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/HexRaysSA/ida-codemode",
        "ida-codemode-mcp",
        "--agent",
        "my-agent",
        "--install-plugin"
      ]
    }
  }
}
```
