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.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ida_hcli-0.20.1.tar.gz.
File metadata
- Download URL: ida_hcli-0.20.1.tar.gz
- Upload date:
- Size: 190.9 kB
- Tags: Source
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1d7b89436ec59eefeabd16309fc70eaa3157a75dde6338203a7dacdfc3e9b517
|
|
| MD5 |
505ac7daf7ff9eb94b798ed96e27ac73
|
|
| BLAKE2b-256 |
bead1396580e5508c77a5ac2188def0b6984c81836790df5f50764943e4735b0
|
File details
Details for the file ida_hcli-0.20.1-py3-none-any.whl.
File metadata
- Download URL: ida_hcli-0.20.1-py3-none-any.whl
- Upload date:
- Size: 238.7 kB
- Tags: Python 3
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a539b8a2af7b06ba2c12b8fd9d131c5f2042e3b3d2731dc28ac0da560e984baa
|
|
| MD5 |
6ff50d3f429279f7234454398765a796
|
|
| BLAKE2b-256 |
6a3fe3b02bca81afaec5dc0d8fb7ce9ebd86f1f377564da3754559336e021c28
|
