CLI Overview
Install and operate Certyn from terminal workflows and CI pipelines.
certyn is the primary interface for developer loops, CI gates, and runner operations.
Use CLI commands as the default integration path. Use raw HTTP only when you need direct API control.
Core command groups
certyn askcertyn runcertyn diagnosecertyn login,certyn whoami,certyn doctor,certyn initcertyn issues ...certyn tests ...certyn executions ...certyn environments ...certyn projects ...certyn observations ...certyn runners ...certyn config ...
Command migration
Older docs and examples may still show removed names. Use these replacements:
| Old | New |
|---|---|
certyn verify | certyn run |
certyn ci run | certyn run |
certyn ci status | certyn run status |
certyn ci wait | certyn run wait |
certyn ci cancel | certyn run cancel |
certyn ci list | certyn run list |
certyn testcases ... | certyn tests ... |
certyn env ... | certyn environments ... |
certyn tickets ... | certyn issues ... |
Canonical run command
certyn run smoke --project <project-slug> --environment <environment-key>
Process aliases
smoke->smoke-suiteregression->regression-suiteexplore->app-explorer
Unknown aliases are treated as explicit process slugs.
Output modes
- Human-readable by default
--jsonfor structured output- Auto GitHub outputs on
run,run status, andrun waitwhenGITHUB_OUTPUTis present
Next steps
Install
Install the CLI on macOS, Linux, Windows, and CI runners.
Read more
Auth & Config
Set API keys, profiles, defaults, and config precedence.
Read more
Commands
Full command catalog with examples for CI, runners, projects, and environments.
Read more
CI Integration
GitHub and generic CI patterns using both certyn/action and direct CLI steps.
Read more
Triage Workflows
Investigate issues, testcases, and executions after CI failures.
Read more