IDA HCLI
A modern command-line interface for managing IDA Pro licenses, downloads, ...
Quickstart
curl -LsSf https://hcli.docs.hex-rays.com/install | sh
# or on Windows
iwr -useb https://hcli.docs.hex-rays.com/install.ps1 | iex
hcli login
hcli license list
See Installation for more details.
Documentation
See https://hcli.docs.hex-rays.com/
Contributing
HCLI is under heavy active development by our team. We are not accepting external contributions at this time due to:
- Rapid development and frequent breaking changes
- Tight integration requirements with our proprietary IDA Pro workflows
- Internal roadmap priorities and architectural decisions
However feel free to report bugs or suggest features via Issues
For our internal team, please see our Contributing Guidelines for development setup and workflow.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Issues and Support
- Bug Reports & Feature Requests: GitHub Issues
- Questions & Discussions: Discussions
- Documentation: Auto-generated from source code at build time
- Commercial Support: Contact support@hex-rays.com
- Hex-Rays Website: hex-rays.com
Development
Prerequisites
- Python 3.10 or higher
- uv package manager
Setup
# Clone the repository
git clone https://github.com/HexRaysSA/ida-hcli.git
cd ida-hcli
# Install dependencies
uv sync
# Run in development mode
uv run hcli --help
Build System
# Install with development dependencies
uv sync --extra dev
# Build package
uv build
# Run development tools
uvx ruff format
uvx ruff check --fix
uvx ruff check --select I --fix
uvx mypy --check-untyped-defs src/ tests/ --exclude tests/data/ --disable-error-code=import-untyped --disable-error-code=import-not-found
Documentation
Documentation is automatically generated from source code:
# Build documentation
uv run mkdocs build
# Serve documentation locally
uv run mkdocs serve
# Documentation includes:
# - CLI commands (from Click help text)
# - API reference (from Python docstrings)
# - Usage examples (auto-generated)
Testing
# Run tests
uv run pytest
# Test CLI commands
uv run hcli whoami
uv run hcli plugin list
See CONTRIBUTING.md for detailed development guidelines.
Release files for ida-hcli 0.27.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| ida_hcli-0.27.1.tar.gz | 275.8 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ida_hcli-0.27.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 609.8 kB
Release files / ida_hcli-0.27.1.tar.gz
| Download URL | ida_hcli-0.27.1.tar.gz |
|---|---|
| Size | 275.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c7cbc03d9b55adad1d5eaddd23ba173bd16cbaf90b6c47a87448bd9ebbe71540
|
|
BLAKE2b-256 checksum How to use checksums |
ac680c141f04a167aab08bea00c26d390511293292836866a528c3b01f185a62
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.10.6 {"installer":{"name":"uv","version":"0.10.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logRelease files / ida_hcli-0.27.1-py3-none-any.whl
| Download URL | ida_hcli-0.27.1-py3-none-any.whl |
|---|---|
| Size | 334.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4b612c685c4ee6d26fb2ba1c2dac7c042f4f4d88f0cf62a0a117b7982f8fd8e7
|
|
BLAKE2b-256 checksum How to use checksums |
80635130c2af0fe71da15fcfc520ca394f0bb28ae8dffa0fbc9eb1d23d5a1c12
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.10.6 {"installer":{"name":"uv","version":"0.10.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logSecurity for ida-hcli 0.27.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for ida_hcli-0.27.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
