zriz quick start

Install zz, log in, make a project, and run the first test. The work is done when the run has status pass.

Draft. Guide · zz 0.9.0 or later · Updated 2026-10-14 · Plain text for agents: /docs.md

Run these four commands in the folder of your service:

curl -fsSL https://zriz.io/install | sh
~/.local/bin/zz login
~/.local/bin/zz init --url http://localhost:3000
~/.local/bin/zz run hello

What the commands do

zz login opens a browser tab. Sign in or sign up there. The e-mail link brings you back.
zz init writes the folder .zriz with the test hello. It does one GET on your app and expects status 200.
zz run hello runs the test from your computer.

The last line shows "status":"pass". If it fails, do the command in hints.

Word	Meaning
zz	The command line tool.
project	The folder `.zriz` of one service.
pipeline	One test: a JSON file of steps and checks.
resource	A thing that a pipeline calls: an HTTP API, a database, a web page, a command.
env	The place where a run occurs, for example `local` or `staging`.
runner	The program that calls your resources. It is inside zz.
run	One time that a pipeline operated. It passes or fails.

Run zz login --no-wait. Give the URL and the code of its reply to the person. Then run zz login again.

zz never asks a question. Each command prints one JSON object, and hints names the next command.