Skip to main content

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

CommandDescriptionDocumentation
hackagentLaunch TUI interfaceQuick Start
hackagent initInteractive setup wizardInitialization
hackagent configManage configurationConfig
hackagent evalRun quick 3-attack security scanEvaluation Campaign
hackagent eval <attack_name>Execute one specific attack strategyEval
hackagent examples ollamaRun built-in Ollama demoQuick Start (TUI tab)
hackagent resultsView and manage resultsResults
hackagent versionShow 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:

OptionDescription
-v, -vv, -vvvIncrease verbosity level
--config-fileUse custom config file
--helpShow help message

Get Help

# General help
hackagent --help

# Command-specific help
hackagent eval --help
hackagent config --help