New:System Graph 2.0See System Graph 2.0
Developer Tools

Zof CLI Reference

Powerful command-line interface for running tests, managing agents, and integrating Zof into your development workflow.

Terminal
$ npm install -g @zof-ai/cli

Quick Start

1

Install CLI

npm install -g @zof-ai/cli
2

Authenticate

zof auth login
3

Run Tests

zof test --type e2e

Command Reference

zof init

Initialize Zof in your project

Example

$ zof init --project my-app

Options

--projectProject name
--orgOrganization ID
--tokenAPI token (or use ZOF_TOKEN env)
zof test

Run tests against your application

Example

$ zof test --type e2e --env staging

Options

--typeTest type (e2e, api, security, load, etc.)
--envTarget environment
--parallelNumber of parallel workers
--timeoutTest timeout in seconds
zof agent

Manage AI testing agents

Example

$ zof agent list --active

Options

listList available agents
runRun a specific agent
statusCheck agent status
zof graph

Interact with the System Graph

Example

$ zof graph sync --branch main

Options

syncSync codebase to graph
queryQuery the graph
exportExport graph data
zof report

Generate and view test reports

Example

$ zof report --format html --output ./reports

Options

--formatOutput format (html, json, junit)
--outputOutput directory
--openOpen in browser after generation
zof ci

CI/CD pipeline integration

Example

$ zof ci run --wait --fail-fast

Options

--waitWait for completion
--fail-fastStop on first failure
--coverageInclude coverage report

Environment Variables

VariableDescriptionDefault
ZOF_TOKENAPI authentication token-
ZOF_ORG_IDOrganization identifier-
ZOF_PROJECTDefault project name-
ZOF_ENVTarget environmentstaging
ZOF_LOG_LEVELLogging verbosityinfo
ZOF_TIMEOUTDefault timeout (seconds)300

Related Resources

Need Help?

Need Help?

Our support team is here to help you get the most out of Zof.

CLI Reference | Zof Documentation | Zof AI