# IDA HCLI
[](https://badge.fury.io/py/ida-hcli)
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
A modern command-line interface for managing IDA Pro licenses, downloads, ...
# Documentation
See [https://hcli.docs.hex-rays.com/](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](CONTRIBUTING.md) for development setup and workflow.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Issues and Support
- **Bug Reports & Feature Requests**: [GitHub Issues](https://github.com/HexRaysSA/ida-hcli/issues)
- **Questions & Discussions**: [Discussions](https://community.hex-rays.com/)
- **Documentation**: Auto-generated from source code at build time
- **Commercial Support**: Contact support@hex-rays.com
- **Hex-Rays Website**: [hex-rays.com](https://hex-rays.com/)
## Development
### Prerequisites
- Python 3.10 or higher
- [uv](https://docs.astral.sh/uv/) package manager
### Setup
```bash
# 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
```bash
# Install with development dependencies
uv sync --extra dev
# Build package
uv build
# Run development tools
uv run ruff format
uv run ruff check --fix
uv run ruff check --select I --fix
```
### Documentation
Documentation is **automatically generated** from source code:
```bash
# 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
```bash
# Run tests
uv run pytest
# Test CLI commands
uv run hcli whoami
uv run hcli plugin list
```
See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed development guidelines.
Raw data
{
"_id": null,
"home_page": null,
"name": "ida-hcli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "ida, ida-pro, reverse-engineering, disassembler, binary-analysis, malware-analysis, security",
"author": null,
"author_email": "Hex-Rays SA <support@hex-rays.com>",
"download_url": "https://files.pythonhosted.org/packages/7a/fd/36f342863f1089e5628fededfdfde71549f0038cc7dbf7ce12b20e4bbfd0/ida_hcli-0.8.2.tar.gz",
"platform": null,
"description": "# IDA HCLI\n\n[](https://badge.fury.io/py/ida-hcli)\n[](https://opensource.org/licenses/MIT)\n[](https://www.python.org/downloads/)\n\n\n\n\nA modern command-line interface for managing IDA Pro licenses, downloads, ...\n\n# Documentation\n\nSee [https://hcli.docs.hex-rays.com/](https://hcli.docs.hex-rays.com/)\n\n## Contributing\n\nHCLI is under heavy active development by our team. We are not accepting external contributions at this time due to:\n\n- Rapid development and frequent breaking changes\n- Tight integration requirements with our proprietary IDA Pro workflows\n- Internal roadmap priorities and architectural decisions\n\nHowever feel free to report bugs or suggest features via Issues\n\nFor our internal team, please see our [Contributing Guidelines](CONTRIBUTING.md) for development setup and workflow.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Issues and Support\n\n- **Bug Reports & Feature Requests**: [GitHub Issues](https://github.com/HexRaysSA/ida-hcli/issues)\n- **Questions & Discussions**: [Discussions](https://community.hex-rays.com/)\n- **Documentation**: Auto-generated from source code at build time\n- **Commercial Support**: Contact support@hex-rays.com\n- **Hex-Rays Website**: [hex-rays.com](https://hex-rays.com/)\n\n## Development\n\n### Prerequisites\n\n- Python 3.10 or higher\n- [uv](https://docs.astral.sh/uv/) package manager\n\n### Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/HexRaysSA/ida-hcli.git\ncd ida-hcli\n\n# Install dependencies\nuv sync\n\n# Run in development mode\nuv run hcli --help\n```\n\n### Build System\n\n```bash\n# Install with development dependencies\nuv sync --extra dev \n\n# Build package\nuv build \n\n# Run development tools\nuv run ruff format\nuv run ruff check --fix\nuv run ruff check --select I --fix\n```\n\n### Documentation\n\nDocumentation is **automatically generated** from source code:\n\n```bash\n# Build documentation\nuv run mkdocs build\n\n# Serve documentation locally\nuv run mkdocs serve\n\n# Documentation includes:\n# - CLI commands (from Click help text)\n# - API reference (from Python docstrings)\n# - Usage examples (auto-generated)\n```\n\n### Testing\n\n```bash\n# Run tests\nuv run pytest\n\n# Test CLI commands\nuv run hcli whoami\nuv run hcli plugin list\n```\n\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed development guidelines.\n",
"bugtrack_url": null,
"license": null,
"summary": "HCLI - Hex-Rays CLI Utility",
"version": "0.8.2",
"project_urls": {
"Homepage": "https://hex-rays.com/",
"Issues": "https://github.com/HexRaysSA/ida-hcli/issues",
"Repository": "https://github.com/HexRaysSA/ida-hcli"
},
"split_keywords": [
"ida",
" ida-pro",
" reverse-engineering",
" disassembler",
" binary-analysis",
" malware-analysis",
" security"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1aa8533ccf11937f4fdd0ba41ddf2f5c70b5755639320fdf018defac4c02f5ab",
"md5": "e3dbad718dc77ceb5a4f08f1badf3f6d",
"sha256": "5e1e237600525eea74e8c823e5f36b58f7275b9ba7a291f9e56bb40276419e0e"
},
"downloads": -1,
"filename": "ida_hcli-0.8.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e3dbad718dc77ceb5a4f08f1badf3f6d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 85930,
"upload_time": "2025-08-27T14:02:51",
"upload_time_iso_8601": "2025-08-27T14:02:51.415012Z",
"url": "https://files.pythonhosted.org/packages/1a/a8/533ccf11937f4fdd0ba41ddf2f5c70b5755639320fdf018defac4c02f5ab/ida_hcli-0.8.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7afd36f342863f1089e5628fededfdfde71549f0038cc7dbf7ce12b20e4bbfd0",
"md5": "0cd8a5345f60a8618f6ce665891330c0",
"sha256": "233bd3026114e4e66ae5d64772cb31002ede313cfa83f0af9e072cbb7bfe0594"
},
"downloads": -1,
"filename": "ida_hcli-0.8.2.tar.gz",
"has_sig": false,
"md5_digest": "0cd8a5345f60a8618f6ce665891330c0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 64819,
"upload_time": "2025-08-27T14:02:52",
"upload_time_iso_8601": "2025-08-27T14:02:52.857389Z",
"url": "https://files.pythonhosted.org/packages/7a/fd/36f342863f1089e5628fededfdfde71549f0038cc7dbf7ce12b20e4bbfd0/ida_hcli-0.8.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-27 14:02:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "HexRaysSA",
"github_project": "ida-hcli",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ida-hcli"
}
JSON
