Quick start

Get from zero to a running test in a few minutes. The API lives at https://prod.testzeus.app/api.

Prerequisites

A TestZeus account and Python 3.11+. Sign up at https://prod.testzeus.app.

1. Install the CLI

pip install testzeus-cli

2. Authenticate

testzeus login

You’ll be prompted for your email and password; credentials are stored securely in your system keyring.

3. Run your first test

Pick whichever fits your workflow — the same task, across every surface:

CLI

testzeus tests list          # list your tests
testzeus tests get <id>      # inspect one

See the full CLI reference for every command and option.

Python SDK

from testzeus_sdk import TestZeusClient

client = TestZeusClient(base_url="https://prod.testzeus.app/api")
test = await client.tests.get_one("my-test-id")
print(test.name, test.status)

The SDK reference lists the client’s auth options and every manager (tests, test runs, environments, tags, and more).

MCP client

Point your MCP client (Claude Desktop, Cursor) at the TestZeus MCP server and its tools appear automatically. See MCP Tools.

Coding agent (skills)

Point Claude Code / Codex / Cursor at the testzeus-skills repo, then ask in plain English:

“Create a login test for my app and run it, then show me the results.”

The agent loads the right skill and drives the CLI/SDK for you. Browse the Skills catalog.

Tip

New to TestZeus? Start with the Coding agent tab — describe what to test in plain English and let your agent drive TestZeus end to end.