CLI reference#

Drive TestZeus from your terminal — best for quick checks, shell scripts, and CI pipelines. Install with pip install testzeus-cli, then testzeus login.

Source: test-zeus-ai/testzeus-cli · auto-generated from this repo on every build (nightly + on source change) — to change this page, change the code

Common workflow#

testzeus login                 # authenticate (stored in your keyring)
testzeus tests list            # list your tests
testzeus tests get <id>        # inspect one

Tip

Add --profile <name> to any command to target a specific login/environment, and --help to see options for any command or group.

Every command and option is listed below.

Top-level commands#

`testzeus daemon`#

Start the TestZeus realtime daemon for Hermes subscriptions.

This daemon handles all PocketBase connections for Hermes. Hermes connects via HTTP/SSE to receive real-time updates.

Example: testzeus daemon –pocketbase-url http://localhost:8090 –pocketbase-token

Environment Variables: POCKETBASE_URL - PocketBase server URL POCKETBASE_AUTH_TOKEN - Auth token for PocketBase

Hermes Connection: http://127.0.0.1:8080/subscribe/{generator_id}

Option	Description
`--host`	Host to bind to (default: 127.0.0.1 for local connections)
`--port`	Port to bind to (default: 8080)
`--pocketbase-url`	PocketBase server URL (env: POCKETBASE_URL)
`--pocketbase-token`	PocketBase auth token (env: POCKETBASE_AUTH_TOKEN)
`--log-level`	Logging level

Option	Description
`--email`	Your TestZeus email
`--password`	Your TestZeus password
`--save`	Save credentials to config

`testzeus logout`#

Log out from TestZeus

`testzeus session-clear`#

Clear a session profile and remove stored credentials.

This command removes the session profile created by session-exchange, effectively logging out from that session.

Example: testzeus auth session-clear –profile hermes-sess_abc123

Option	Description
`--profile`	Session profile to clear

`testzeus session-exchange`#

Exchange a PocketBase JWT for a session-scoped CLI authentication.

This command is used by Hermes to establish a CLI session from a UI-provided PocketBase JWT. The session is stored in a separate profile and can be used for subsequent CLI operations.

Example: testzeus auth session-exchange –token <pocketbase_jwt>

Option	Description
`--token`	PocketBase JWT token from UI
`--profile`	Session profile name (auto-generated if not provided)
`--tenant-id`	Tenant ID hint from UI/Hermes
`--user-id`	User ID hint from UI/Hermes
`--email`	Email hint from UI/Hermes

`testzeus session-list`#

List all session profiles.

This command shows all Hermes session profiles currently stored.

Example: testzeus auth session-list

`testzeus session-status`#

Check the status of a session profile.

This command shows the current authentication status of a session profile, including user info and whether the token is valid.

Example: testzeus auth session-status –profile hermes-sess_abc123

Option	Description
`--profile`	Session profile to check

`testzeus whoami`#

Show current user information

`testzeus agent-harness`#

Adversarial testing of AI agents (Agent Harness)

`testzeus agent-harness cancel <group_id>`#

Cancel a running simulation group

`testzeus agent-harness delete-pathway <pathway_id>`#

Soft-delete an adversarial pathway

`testzeus agent-harness generate-pathways <agent_profile>`#

Start an AI pathway-generation job for a Salesforce agent profile

Option	Description
`--prompt`	Directional prompt for pathway generation
`--name`	Generation job name (auto-generated if omitted)
`--agent-name`	Agent display name
`--num`	Number of pathways to generate
`--allow-destructive`	Allow destructive scenarios

`testzeus agent-harness get-agent <agent_id>`#

Get full detail for a single agent

`testzeus agent-harness get-pathway <pathway_id>`#

Get full detail for a single adversarial pathway

`testzeus agent-harness get-simulation <simulation_id>`#

Get full detail for a single simulation

`testzeus agent-harness list-agents`#

List available agents

Option	Description
`--page`	Page number
`--per-page`	Results per page
`--status`	Filter by status
`--search`	Search term

`testzeus agent-harness list-pathways <agent_id>`#

List adversarial pathways for an agent

Option	Description
`--page`	Page number
`--per-page`	Results per page

`testzeus agent-harness list-simulations <group_id>`#

List the simulations of a run group

Option	Description
`--page`	Page number
`--per-page`	Results per page

`testzeus agent-harness run <agent_id>`#

Run adversarial simulations for the given pathways

Option	Description
`--pathway`	Pathway ID to run (repeatable)
`--name`	Run name (auto-generated if omitted)
`--agent-name`	Agent display name
`--run-as-profile`	Salesforce profile to run as (RBAC)
`--wait`	Wait and poll until the run finishes
`--timeout`	Max seconds to wait when –wait is set

`testzeus agent-harness status <group_id>`#

Get the status/results of a simulation run group

`testzeus connected-environments`#

Manage connected environments in TestZeus

`testzeus connected-environments get <conn_env_id>`#

Get a connected environment by ID

Option	Description
`--expand`	Expand related entities

`testzeus connected-environments list`#

List all connected environments

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities

`testzeus connected-environments update <conn_env_id>`#

Update a connected environment’s name

Option	Description
`--name`	New connected environment name

`testzeus device-pool`#

Browse available devices in the device pool (read-only)

`testzeus device-pool get <device_id>`#

Get a device by ID

`testzeus device-pool list`#

List available devices in the pool

Option	Description
`--filters`	Filter results (format: key=value, e.g. platform=android)
`--sort`	Sort by field (e.g. device_name, -platform_version)
`--page`	Page number
`--per-page`	Items per page

`testzeus environments`#

Manage environments in TestZeus

`testzeus environments create`#

Create a new environment

Option	Description
`--name`	Environment name
`--device-type`	Device type (default: browser)
`--data`
`--data-file`	Path to JSON file with environment data in the required format
`--tags`	Comma-separated list of tags
`--connected-environments`	Comma-separated list of environment IDs or names to connect (browser only)
`--file`	Path to supporting data file (browser only)
`--mobile-file`	Path to mobile app file - APK/ZIP (mobile only)
`--mobile-device`	Device pool ID or device_name (mobile only; use ‘device-pool list’ to discover)
`--email-manager`	Comma-separated list of email manager integration IDs or names (browser only)
`--source-code-integrations`	Comma-separated list of source code integration IDs or names
`--agent-grounding-prompt`	Agent grounding prompt (JSON string)

`testzeus environments delete <env_id>`#

Delete an environment

`testzeus environments delete-all-files <env_id>`#

Delete all files from an environment

`testzeus environments get <env_id>`#

Get an environment by ID

Option	Description
`--expand`	Expand related entities

`testzeus environments list`#

List all environments

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities

`testzeus environments remove-file <env_id> <file_path>`#

Remove a file from an environment

`testzeus environments update <env_id>`#

Update an environment

Option	Description
`--name`	New environment name
`--device-type`	Device type
`--data`
`--data-file`	Path to JSON file with new environment data in the required format
`--tags`	Comma-separated list of tags
`--connected-environments`	Comma-separated list of environment IDs or names to connect (browser only)
`--file`	Path to supporting data file (browser only)
`--mobile-file`	Path to mobile app file - APK/ZIP (mobile only)
`--mobile-device`	Device pool ID or device_name (mobile only; use ‘none’ to clear)
`--email-manager`	Comma-separated list of email manager integration IDs or names (browser only, use ‘none’ to clear)
`--source-code-integrations`	Comma-separated list of source code integration IDs or names (use ‘none’ to clear)
`--agent-grounding-prompt`	Agent grounding prompt (JSON string, use ‘none’ to clear)

`testzeus environments upload-file <env_id> <file_path>`#

Upload a file to a browser environment

`testzeus environments upload-mobile-file <env_id> <file_path>`#

Upload a mobile app file to a mobile environment

`testzeus extension`#

Manage TestZeus extensions

`testzeus extension create`#

Create a new extension

Option	Description
`--name`	Extension name
`--data-content`	Data content as text
`--data-file`	Path to file containing data content

`testzeus extension delete <extension_id>`#

Delete an extension

`testzeus extension get <extension_id>`#

Get a single extension by ID

Option	Description
`--expand`	Expand related entities (comma-separated)

`testzeus extension list`#

List extensions with optional filters and sorting

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities (comma-separated)
`--page`	Page number
`--per-page`	Items per page

`testzeus hypermind-code-blocks`#

Manage TestZeus Hypermind code blocks

`testzeus hypermind-code-blocks create`#

Create new Hypermind code block

Option	Description
`--name`	Hypermind code block name
`--status`	Code block status (draft, ready, deleted)
`--tags`	Comma-separated list of tags
`--file`	Path to code file(s) to upload

`testzeus hypermind-code-blocks delete <code_block_id>`#

Delete Hypermind code block

`testzeus hypermind-code-blocks delete-all-files <code_block_id>`#

Delete all code files from a Hypermind code block

`testzeus hypermind-code-blocks get <code_block_id>`#

Get a single Hypermind code block by ID

Option	Description
`--expand`	Expand related entities

`testzeus hypermind-code-blocks list`#

List Hypermind code blocks with optional filters and sorting

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities

`testzeus hypermind-code-blocks remove-file <code_block_id> <file_path>`#

Remove a specific code file from a Hypermind code block

`testzeus hypermind-code-blocks update <code_block_id>`#

Update an existing Hypermind code block

Option	Description
`--name`	New code block name
`--status`	New code block status (draft, ready, deleted)
`--tags`	Comma-separated list of tags
`--file`	Path to code file(s) to add

`testzeus hypermind-code-blocks upload-file <code_block_id> <file_path>`#

Upload a code file to a Hypermind code block

`testzeus knowledge-bases`#

Manage knowledge bases in TestZeus

`testzeus knowledge-bases get <kb_id>`#

Get a knowledge base by id

Option	Description
`--expand`	Expand related entities

`testzeus knowledge-bases list`#

List all knowledge bases

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities

`testzeus notification`#

Manage TestZeus notification channels

`testzeus notification create`#

Create a new notification channel

Option	Description
`--name`	Channel name
`--emails`	Email addresses (comma-separated)
`--webhooks`	Webhook URLs (comma-separated)
`--is-active`	Set channel as active (true/false)
`--is-default`	Set as default channel (true/false)

`testzeus notification delete <channel_id>`#

Delete a notification channel

`testzeus notification get <channel_id>`#

Get a single notification channel by ID

Option	Description
`--expand`	Expand related entities (comma-separated)

`testzeus notification list`#

List notification channels with optional filters and sorting

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities (comma-separated)
`--page`	Page number
`--per-page`	Items per page

`testzeus notification update <channel_id>`#

Update an existing notification channel

Option	Description
`--name`	New channel name
`--emails`	Email addresses (comma-separated)
`--webhooks`	Webhook URLs (comma-separated)
`--is-active`	Set channel as active (true/false)
`--is-default`	Set as default channel (true/false)

`testzeus schedule`#

Manage TestZeus test report schedules

`testzeus schedule create`#

Create a new test report schedule

Option	Description
`--name`	Schedule name
`--is-active`	Set schedule as active (true/false)
`--cron-expression`	Cron expression for scheduling
`--filter-name-pattern`	Filter by test name pattern
`--filter-tag-pattern`	Filter by tag pattern
`--filter-env-pattern`	Filter by environment pattern
`--filter-test-data-pattern`	Filter by test data pattern
`--filter-tags`	Filter by specific tag IDs (comma-separated)
`--filter-env`	Filter by specific environment IDs (comma-separated)
`--filter-test-data`	Filter by specific test data IDs (comma-separated)
`--filter-time-intervals`	Time intervals in format ‘start_time,end_time’ (e.g., ‘2025-01-01 00:00:00,2025-01-01 01:00:00’)
`--notification-channels`	Notification channel IDs (comma-separated)

`testzeus schedule delete <schedule_id>`#

Delete a test report schedule

`testzeus schedule get <schedule_id>`#

Get a single test report schedule by ID

Option	Description
`--expand`	Expand related entities (comma-separated)

`testzeus schedule list`#

List test report schedules with optional filters and sorting

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities (comma-separated)
`--page`	Page number
`--per-page`	Items per page

`testzeus schedule update <schedule_id>`#

Update an existing test report schedule

Option	Description
`--name`	New schedule name
`--is-active`	Set schedule as active (true/false)
`--cron-expression`	Cron expression for scheduling
`--filter-name-pattern`	Filter by test name pattern
`--filter-tag-pattern`	Filter by tag pattern
`--filter-env-pattern`	Filter by environment pattern
`--filter-test-data-pattern`	Filter by test data pattern
`--filter-tags`	Filter by specific tag IDs (comma-separated)
`--filter-env`	Filter by specific environment IDs (comma-separated)
`--filter-test-data`	Filter by specific test data IDs (comma-separated)
`--filter-time-intervals`	Time intervals in format ‘start_time,end_time’ (e.g., ‘2025-01-01 00:00:00,2025-01-01 01:00:00’)
`--notification-channels`	Notification channel IDs (comma-separated)

`testzeus tags`#

Manage tags in TestZeus

`testzeus tags create`#

Create a new tag

Option	Description
`--name`	Tag name
`--value`	Tag value

`testzeus tags delete <name>`#

Delete a tag

`testzeus tags get <tag_id>`#

Get a tag by id

Option	Description
`--expand`	Expand related entities

`testzeus tags list`#

List all tags

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities

`testzeus tags update <tags_id>`#

Update a tag

Option	Description
`--name`	New tag name
`--value`	New tag value

`testzeus test-data`#

Manage TestZeus test data

`testzeus test-data create`#

Create new test data

Option	Description
`--name`	Test data name
`--data`
`--data-file`	Path to JSON file with test data in the required format
`--file`	Path to supporting data file to upload

`testzeus test-data delete <test_data_id>`#

Delete test data

`testzeus test-data delete-all-files <test_data_id>`#

Delete all files from a test data

`testzeus test-data get <test_data_id>`#

Get a single test data by ID

Option	Description
`--expand`	Expand related entities

`testzeus test-data list`#

List test data with optional filters and sorting

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities

`testzeus test-data remove-file <test_data_id> <file_path>`#

Remove a file from a test data

`testzeus test-data update <test_data_id>`#

Update an existing test data

Option	Description
`--name`	New test data name
`--data`
`--data-file`	Path to JSON file with new test data in the required format
`--file`	Path to supporting data file to upload

`testzeus test-data upload-file <test_data_id> <file_path>`#

Upload a file to a test data

`testzeus test-report-runs`#

Manage test report runs in TestZeus

`testzeus test-report-runs delete <report_run_id>`#

Delete a test report run

`testzeus test-report-runs download <report_run_id>`#

Download the report for a test report run

Option	Description
`--output-dir`	Output directory for downloaded report (default: downloads)
`--format`	Report format (default: pdf)

`testzeus test-report-runs get <report_run_id>`#

Get a test report run by ID

Option	Description
`--expand`	Expand related entities

`testzeus test-report-runs list`#

List all test report runs

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities

`testzeus test-run-group`#

Manage TestZeus test run groups

`testzeus test-run-group cancel <test_run_group_id>`#

Cancel a running test run group

`testzeus test-run-group delete <test_run_group_id>`#

Delete a test run group

`testzeus test-run-group download-attachments <test_run_group_id>`#

Download all attachments for all test runs in a test run group

Option	Description
`--output-dir`	Base directory to save attachments (default: downloads)

`testzeus test-run-group download-report <test_run_group_id>`#

Download the report for a test run group

Option	Description
`--output-dir`	Output directory for downloaded report (default: downloads)
`--format`	Report format (default: pdf)

`testzeus test-run-group execute`#

Execute a new test run group

Option	Description
`--name`	Test run group name (unique identifier)
`--execution-mode`	Execution mode (default: lenient)
`--tags`	Tag IDs to associate with the group (comma-separated)
`--test-ids`	Test IDs to include in the group (comma-separated)
`--environment`	Environment ID
`--notification-channels`	Notification channel IDs (comma-separated)

`testzeus test-run-group execute-and-monitor`#

Execute a test run group and monitor until completion, then download the report

Option	Description
`--name`	Test run group name (unique identifier)
`--execution-mode`	Execution mode (default: lenient)
`--tags`	Tag IDs to associate with the group (comma-separated)
`--test-ids`	Test IDs to include in the group (comma-separated)
`--environment`	Environment ID
`--notification-channels`	Notification channel IDs (comma-separated)
`--interval`	Sleep interval between status checks in seconds (default: 30)
`--output-dir`	Output directory for downloaded report (default: downloads)
`--format`	Report format (default: ctrf)
`--filename`	Filename for the report (default: ctrf-report.json)

`testzeus test-run-group execute-and-monitor-status`#

Execute a test run group and monitor until status is completed (no report download)

This command creates a test run group, executes it, and monitors the status until completion. Unlike execute-and-monitor, this command does NOT wait for CTRF report generation or download any reports. Always uses ‘lenient’ execution mode.

Option	Description
`--name`	Test run group name (unique identifier)
`--tags`	Tag IDs to associate with the group (comma-separated)
`--test-ids`	Test IDs to include in the group (comma-separated)
`--environment`	Environment ID
`--notification-channels`	Notification channel IDs (comma-separated)
`--interval`	Sleep interval between status checks in seconds (default: 30)

`testzeus test-run-group get <test_run_group_id>`#

Get a single test run group by ID

Option	Description
`--expand`	Expand related entities (comma-separated)

`testzeus test-run-group get-status <test_run_group_id>`#

Get the status summary of a test run group

`testzeus test-run-group list`#

List test run groups with optional filters and sorting

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities (comma-separated)
`--page`	Page number
`--per-page`	Items per page

`testzeus test-runs`#

Manage TestZeus test runs

`testzeus test-runs download-attachment <attachment_id>`#

Download a specific attachment by its ID (see get-expanded for IDs)

Option	Description
`--output-dir`	Directory to save the attachment

`testzeus test-runs download-attachments <test_run_id>`#

Download all attachments for a test run

Option	Description
`--output-dir`	Directory to save attachments

`testzeus test-runs get <test_run_id>`#

Get a single test run by ID

Option	Description
`--expand`	Expand related entities

`testzeus test-runs get-expanded <test_run_id>`#

Get expanded details for a test run including all outputs and steps

`testzeus test-runs list`#

List test runs with optional filters and sorting

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities
`--page`	Page number
`--per-page`	Items per page

`testzeus test-runs status <test_run_id>`#

Get the status of a test run

`testzeus test-runs watch <test_run_id>`#

Watch a test run until completion

Option	Description
`--interval`	Check interval in seconds

`testzeus test-suite-node-runs`#

Manage TestZeus test suite node runs

`testzeus test-suite-node-runs get <node_run_id>`#

Get a test suite node run by ID.

Option	Description
`--expand`	Expand related entities

`testzeus test-suite-node-runs list`#

List test suite node runs.

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities
`--page`	Page number
`--per-page`	Items per page

`testzeus test-suite-runs`#

Manage TestZeus test suite runs

`testzeus test-suite-runs cancel <suite_run_id>`#

Cancel a test suite run.

`testzeus test-suite-runs create`#

Create a test suite run.

Option	Description
`--name`	Suite run name
`--test-suite`	Test suite ID
`--input-values`	Input values as JSON
`--environment`	Environment ID
`--execution-mode`	Execution mode override
`--notification-channels`	Notification channel IDs (comma-separated)

`testzeus test-suite-runs delete <suite_run_id>`#

Delete a test suite run.

`testzeus test-suite-runs get <suite_run_id>`#

Get a test suite run by ID.

Option	Description
`--expand`	Expand related entities

`testzeus test-suite-runs list`#

List test suite runs.

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities
`--page`	Page number
`--per-page`	Items per page

`testzeus test-suite-runs pause <suite_run_id>`#

Pause a test suite run.

Option	Description
`--mode`
`--reason`	Pause reason

`testzeus test-suite-runs resume <suite_run_id>`#

Resume a test suite run.

`testzeus test-suite-schedules`#

Manage TestZeus test suite schedules

`testzeus test-suite-schedules create`#

Create a test suite schedule.

Option	Description
`--name`	Schedule name
`--test-suite`	Test suite ID
`--cron-expression`	Cron expression
`--input-values`	Schedule input values as JSON
`--environment`	Environment ID
`--notification-channels`	Notification channel IDs (comma-separated)
`--inactive`	Create the schedule inactive

`testzeus test-suite-schedules delete <schedule_id>`#

Delete a test suite schedule.

`testzeus test-suite-schedules get <schedule_id>`#

Get a test suite schedule by ID.

Option	Description
`--expand`	Expand related entities

`testzeus test-suite-schedules list`#

List test suite schedules.

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities
`--page`	Page number
`--per-page`	Items per page

`testzeus test-suite-schedules update <schedule_id>`#

Update a test suite schedule.

Option	Description
`--name`	Schedule name
`--test-suite`	Test suite ID
`--cron-expression`	Cron expression
`--input-values`	Schedule input values as JSON
`--environment`	Environment ID
`--notification-channels`	Notification channel IDs (comma-separated)
`--inactive`	Mark the schedule inactive

`testzeus test-suites`#

Manage TestZeus test suites

`testzeus test-suites create`#

Create a test suite.

Option	Description
`--name`	Test suite name
`--workflow-definition`	Workflow definition as JSON
`--default-inputs`	Default suite inputs as JSON
`--input-schema`	Input schema as JSON
`--description`	Description
`--status`	Suite status
`--execution-mode`	Execution mode
`--environment`	Environment ID
`--tags`	Tag IDs (comma-separated)
`--notification-channels`	Notification channel IDs (comma-separated)

`testzeus test-suites delete <suite_id>`#

Delete a test suite.

`testzeus test-suites get <suite_id>`#

Get a test suite by ID.

Option	Description
`--expand`	Expand related entities

`testzeus test-suites list`#

List test suites.

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities
`--page`	Page number
`--per-page`	Items per page

`testzeus test-suites update <suite_id>`#

Update a test suite.

Option	Description
`--name`	New test suite name
`--workflow-definition`	Workflow definition as JSON
`--default-inputs`	Default suite inputs as JSON
`--input-schema`	Input schema as JSON
`--description`	Description
`--status`	Suite status
`--execution-mode`	Execution mode
`--environment`	Environment ID
`--tags`	Tag IDs (comma-separated)
`--notification-channels`	Notification channel IDs (comma-separated)

`testzeus testcase-generator`#

Manage TestZeus AI test generator

`testzeus testcase-generator create`#

Create a new AI test generator request

Option	Description
`--test-id`	Test ID to generate for
`--test-data`	Test data IDs
`--environment`	Environment ID
`--test-feature`	Test feature text
`--test-feature-file`	Path to file containing test feature
`--user-prompt`	User prompt for AI generation
`--user-prompt-file`	Path to file containing user prompt
`--reasoning-effort`	AI reasoning effort level (default: low)
`--num-testcases`	Number of test cases to generate (1-20, default: 3)
`--testing-type`	Testing type (default: web)
`--knowledge-base`	Knowledge base IDs or names (can be specified multiple times)

`testzeus testcase-generator delete <generator_id>`#

Delete an AI test generator

`testzeus testcase-generator get <generator_id>`#

Get a single AI test generator by ID

Option	Description
`--expand`	Expand related entities (comma-separated)

`testzeus testcase-generator list`#

List AI test generators with optional filters and sorting

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities (comma-separated)
`--page`	Page number
`--per-page`	Items per page

`testzeus tests`#

Manage TestZeus tests

`testzeus tests create`#

Create a new test with feature content from text or file

Option	Description
`--name`	Test name
`--feature`	Test feature content as text
`--feature-file`	Path to file containing feature content (text)
`--test-params`	Default test params as inline JSON
`--test-params-file`	Path to JSON file containing default test params
`--output-schema`	Output schema as inline JSON
`--output-schema-file`	Path to JSON file containing output schema
`--status`	Test status (draft, ready, deleted)
`--data`	Test data IDs
`--tags`	Tag IDs
`--environment`	Environment ID (required for mobile tests)
`--hypermind-code-blocks`	Comma-separated list of Hypermind code block IDs
`--execution-mode`	Execution mode (lenient, strict)
`--testing-type`	Testing type (default: web). Environment is required for mobile.

`testzeus tests delete <test_id>`#

Delete a test

`testzeus tests dependent-suites <test_id>`#

Get test suites that depend on a test.

`testzeus tests get <test_id>`#

Get a single test by ID

Option	Description
`--expand`	Expand related entities

`testzeus tests input-params <test_id>`#

Get merged input params and defaults for a test.

`testzeus tests list`#

List tests with optional filters and sorting

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities

`testzeus tests update <test_id>`#

Update an existing test with feature content from text or file

Option	Description
`--name`	New test name
`--feature`	New test feature content as text
`--feature-file`	Path to file containing new feature content (text)
`--test-params`	Default test params as inline JSON
`--test-params-file`	Path to JSON file containing default test params
`--output-schema`	Output schema as inline JSON
`--output-schema-file`	Path to JSON file containing output schema
`--status`	New test status (draft, ready, deleted)
`--data`	Test data IDs
`--tags`	Tag IDs
`--environment`	Environment ID (required for mobile tests)
`--hypermind-code-blocks`	Comma-separated list of Hypermind code block IDs (use ‘none’ to clear)
`--testing-type`	Testing type. Environment is required for mobile.

`testzeus tests-authoring`#

Manage test authoring - wizard, quick, and manual modes

`testzeus tests-authoring manual`#

Create test with Gherkin feature directly (no AI generation)

Option	Description
`--name`	Test name
`--feature`	Test feature content as text (Gherkin)
`--feature-file`	Path to file containing feature content (Gherkin)
`--test-params`	Default test params as inline JSON
`--test-params-file`	Path to JSON file containing default test params
`--output-schema`	Output schema as inline JSON
`--output-schema-file`	Path to JSON file containing output schema
`--status`	Test status (draft, ready, deleted)
`--data`	Test data IDs
`--tags`	Tag IDs
`--environment`	Environment ID
`--hypermind-code-blocks`	Comma-separated list of Hypermind code block IDs
`--execution-mode`	Execution mode (lenient, strict)

`testzeus tests-authoring quick`#

Quick test generation with minimal prompts

Option	Description
`--name`	Test name
`--description`	Test description
`--count`	Number of test cases to generate (default: 10)
`--complexity`	Complexity level (default: medium)

`testzeus tests-authoring wizard`#

Interactive wizard mode for test authoring

Option	Description
`--name`	Test name (skip prompt if provided)
`--description`	Test description (skip prompt if provided)
`--environment`	Environment ID (skip prompt if provided)
`--test-data`	Test data IDs
`--tags`	Tag IDs
`--scenarios`	Test scenarios/requirements (skip prompt if provided)
`--count`	Number of test cases (skip prompt if provided)
`--complexity`	Complexity level (skip prompt if provided)

`testzeus user-integrations`#

Manage TestZeus user integrations (read-only)

`testzeus user-integrations get <integration_id>`#

Get a single user integration by ID

Option	Description
`--expand`	Expand related entities

`testzeus user-integrations get-first`#

Get the first user integration matching filters

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities

`testzeus user-integrations list`#

List user integrations with optional filters and sorting

Option	Description
`--filters`	Filter results (format: key=value)
`--sort`	Sort by field
`--expand`	Expand related entities

CLI reference#

Common workflow#

Top-level commands#

testzeus daemon#

testzeus login#

testzeus logout#

testzeus session-clear#

testzeus session-exchange#

testzeus session-list#

testzeus session-status#

testzeus whoami#

testzeus agent-harness#

testzeus agent-harness cancel <group_id>#

testzeus agent-harness delete-pathway <pathway_id>#

testzeus agent-harness generate-pathways <agent_profile>#

testzeus agent-harness get-agent <agent_id>#

testzeus agent-harness get-pathway <pathway_id>#

testzeus agent-harness get-simulation <simulation_id>#

testzeus agent-harness list-agents#

testzeus agent-harness list-pathways <agent_id>#

testzeus agent-harness list-simulations <group_id>#

testzeus agent-harness run <agent_id>#

testzeus agent-harness status <group_id>#

testzeus connected-environments#

testzeus connected-environments get <conn_env_id>#

testzeus connected-environments list#

testzeus connected-environments update <conn_env_id>#

testzeus device-pool#

testzeus device-pool get <device_id>#

testzeus device-pool list#

testzeus environments#

testzeus environments create#

testzeus environments delete <env_id>#

testzeus environments delete-all-files <env_id>#

testzeus environments get <env_id>#

testzeus environments list#

testzeus environments remove-file <env_id> <file_path>#

testzeus environments update <env_id>#

testzeus environments upload-file <env_id> <file_path>#

testzeus environments upload-mobile-file <env_id> <file_path>#

testzeus extension#

testzeus extension create#

testzeus extension delete <extension_id>#

testzeus extension get <extension_id>#

testzeus extension list#

testzeus hypermind-code-blocks#

testzeus hypermind-code-blocks create#

testzeus hypermind-code-blocks delete <code_block_id>#

testzeus hypermind-code-blocks delete-all-files <code_block_id>#

testzeus hypermind-code-blocks get <code_block_id>#

testzeus hypermind-code-blocks list#

testzeus hypermind-code-blocks remove-file <code_block_id> <file_path>#

testzeus hypermind-code-blocks update <code_block_id>#

testzeus hypermind-code-blocks upload-file <code_block_id> <file_path>#

testzeus knowledge-bases#

testzeus knowledge-bases get <kb_id>#

testzeus knowledge-bases list#

testzeus notification#

testzeus notification create#

testzeus notification delete <channel_id>#

testzeus notification get <channel_id>#

testzeus notification list#

testzeus notification update <channel_id>#

testzeus schedule#

testzeus schedule create#

testzeus schedule delete <schedule_id>#

testzeus schedule get <schedule_id>#

testzeus schedule list#

testzeus schedule update <schedule_id>#

testzeus tags#

testzeus tags create#

testzeus tags delete <name>#

testzeus tags get <tag_id>#

testzeus tags list#

testzeus tags update <tags_id>#

testzeus test-data#

testzeus test-data create#

testzeus test-data delete <test_data_id>#

testzeus test-data delete-all-files <test_data_id>#

testzeus test-data get <test_data_id>#

`testzeus daemon`#

`testzeus login`#

`testzeus logout`#

`testzeus session-clear`#

`testzeus session-exchange`#

`testzeus session-list`#

`testzeus session-status`#

`testzeus whoami`#

`testzeus agent-harness`#

`testzeus agent-harness cancel <group_id>`#

`testzeus agent-harness delete-pathway <pathway_id>`#

`testzeus agent-harness generate-pathways <agent_profile>`#

`testzeus agent-harness get-agent <agent_id>`#

`testzeus agent-harness get-pathway <pathway_id>`#

`testzeus agent-harness get-simulation <simulation_id>`#

`testzeus agent-harness list-agents`#

`testzeus agent-harness list-pathways <agent_id>`#

`testzeus agent-harness list-simulations <group_id>`#

`testzeus agent-harness run <agent_id>`#

`testzeus agent-harness status <group_id>`#

`testzeus connected-environments`#

`testzeus connected-environments get <conn_env_id>`#

`testzeus connected-environments list`#

`testzeus connected-environments update <conn_env_id>`#

`testzeus device-pool`#

`testzeus device-pool get <device_id>`#

`testzeus device-pool list`#

`testzeus environments`#

`testzeus environments create`#

`testzeus environments delete <env_id>`#

`testzeus environments delete-all-files <env_id>`#

`testzeus environments get <env_id>`#

`testzeus environments list`#

`testzeus environments remove-file <env_id> <file_path>`#

`testzeus environments update <env_id>`#

`testzeus environments upload-file <env_id> <file_path>`#

`testzeus environments upload-mobile-file <env_id> <file_path>`#

`testzeus extension`#

`testzeus extension create`#

`testzeus extension delete <extension_id>`#

`testzeus extension get <extension_id>`#

`testzeus extension list`#

`testzeus hypermind-code-blocks`#

`testzeus hypermind-code-blocks create`#

`testzeus hypermind-code-blocks delete <code_block_id>`#

`testzeus hypermind-code-blocks delete-all-files <code_block_id>`#

`testzeus hypermind-code-blocks get <code_block_id>`#

`testzeus hypermind-code-blocks list`#

`testzeus hypermind-code-blocks remove-file <code_block_id> <file_path>`#

`testzeus hypermind-code-blocks update <code_block_id>`#

`testzeus hypermind-code-blocks upload-file <code_block_id> <file_path>`#

`testzeus knowledge-bases`#

`testzeus knowledge-bases get <kb_id>`#

`testzeus knowledge-bases list`#

`testzeus notification`#

`testzeus notification create`#

`testzeus notification delete <channel_id>`#

`testzeus notification get <channel_id>`#

`testzeus notification list`#

`testzeus notification update <channel_id>`#

`testzeus schedule`#

`testzeus schedule create`#

`testzeus schedule delete <schedule_id>`#

`testzeus schedule get <schedule_id>`#

`testzeus schedule list`#

`testzeus schedule update <schedule_id>`#

`testzeus tags`#

`testzeus tags create`#

`testzeus tags delete <name>`#

`testzeus tags get <tag_id>`#

`testzeus tags list`#

`testzeus tags update <tags_id>`#

`testzeus test-data`#

`testzeus test-data create`#

`testzeus test-data delete <test_data_id>`#

`testzeus test-data delete-all-files <test_data_id>`#

`testzeus test-data get <test_data_id>`#

`testzeus test-data list`#

`testzeus test-data remove-file <test_data_id> <file_path>`#

`testzeus test-data update <test_data_id>`#