zen-cli

Command-line toolbox for Zen Cloud PC, designed for AI and human.

Contents

• Try it out
  • Prerequisites
  • Installation
    • Mac & Linux
    • Windows
  • Use the CLI
• Documentation
• License

Try it out

Prerequisites

• Python 3.12 or newer
• Pip

Installation

Mac & Linux

pip install zen-cli

Windows

pip install zen-cli

If Python was installed without “Add python to PATH”, add Python and its Scripts directory to PATH.

Use the CLI

zen login
zen auth status
zen auth details
zen auth token

zen login reuses a valid cached token or configured credentials (API token, client id/secret). If neither is available it starts device-code login. It does not print the access token. Machine login is zen login --client-id / --client-secret. zen auth status is JSON (logged_in, method, ttl). zen auth details is the JWT and org. zen auth token is the bearer (--service on details/token). zen auth refresh refreshes the cached token.

Run a command, for example, list pools:

zen pool list

Documentation

• User guide — profiles, flags, payloads, and command conventions
• Cheatsheet — command examples
• Developer guide — build, test, and package layout

License

Licensed under the MIT License. See LICENSE.