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 / hackagent tui | Launch the full-screen Terminal User Interface | Quick Start |
hackagent init | Interactive setup wizard | Initialization |
hackagent config | Manage configuration | Config |
hackagent agent | Manage registered agents | Agent |
hackagent eval | Run quick 3-attack security scan | Evaluation Campaign |
hackagent eval <attack_name> | Execute one specific attack strategy | Eval |
hackagent scan <url> | Browser-driven red-teaming of a website's chat widget | Scan |
hackagent claude | Red-team a Claude Code agent | Claude Code |
hackagent codex | Red-team a Codex agent | Codex |
hackagent examples ollama | Run built-in Ollama demo | Quick Start (TUI tab) |
hackagent results | View and manage results | Results |
hackagent datasets | Browse and sample dataset presets | Datasets |
hackagent web | Launch the local dashboard | Web |
hackagent doctor | Diagnose common configuration issues | - |
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