Execute an H3 CLI command with optional arguments.
This tool allows direct execution of any h3-cli command, providing flexible access
to all H3 API capabilities from the command line interface.
Args:
command (str): The H3 command to execute without the 'h3' prefix.
Common commands include 'whoami', 'pentests', 'pentest',
'hello-world', and 'help'.
args (List[str], optional): A list of string arguments for the command.
These will be passed directly to the command.
Returns:
Dict with command output and status. The output field contains the
command's response, either as parsed JSON or raw text.
Examples:
Check the current user identity:
run_h3_command("whoami")
View a specific pentest by ID:
run_h3_command("pentest", ["abc123"])
List all pentests with pagination:
run_h3_command("pentests", ["--page-size", "10", "--page", "1"])
Get help for a specific command:
run_h3_command("help", ["pentest"])
Run a new pentest using a template:
run_h3_command("run-pentest", ["my-template-name"])
Notes:
- To see all available commands, use run_h3_command("help")
- For command-specific help, use run_h3_command("help", ["command_name"])
- Command execution is synchronous and will block until completion