Overview
The HackAgent CLI provides a powerful command-line interface for AI agent security testing. With beautiful ASCII branding, rich terminal output, and comprehensive functionality, it's the fastest way to run security evaluations.
For installation instructions, see the Installation Guide.
Commands
| Command | Description | Documentation |
|---|---|---|
hackagent | Launch TUI interface | Quick Start |
hackagent init | Interactive setup wizard | Initialization |
hackagent config | Manage configuration | Config |
hackagent eval | Run quick 3-attack security scan | Evaluation Campaign |
hackagent eval <attack_name> | Execute one specific attack strategy | Eval |
hackagent examples ollama | Run built-in Ollama demo | Quick Start (TUI tab) |
hackagent results | View and manage results | Results |
hackagent version | Show version info | - |
Quick Examples
Setup
hackagent init
Run an Attack
hackagent eval advprefix \
--agent-name "my-agent" \
--agent-type "google-adk" \
--endpoint "http://localhost:8000" \
--goals "Test security vulnerability"
Run Evaluation Campaign
hackagent eval \
--agent-name "my-agent" \
--agent-type "google-adk" \
--endpoint "http://localhost:8000/chat"
View Results
hackagent results list
Global Options
These options work with all commands:
| Option | Description |
|---|---|
-v, -vv, -vvv | Increase verbosity level |
--config-file | Use custom config file |
--help | Show help message |
Get Help
# General help
hackagent --help
# Command-specific help
hackagent eval --help
hackagent config --help