run_h3_command
Execute H3 CLI commands directly with optional arguments to access Horizon3.ai API functionalities, manage pentests, and automate security workflows from the command line.
Instructions
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
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | No | ||
| command | Yes |
Input Schema (JSON Schema)
{
"properties": {
"args": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Args"
},
"command": {
"title": "Command",
"type": "string"
}
},
"required": [
"command"
],
"title": "run_h3_commandArguments",
"type": "object"
}