`qumod` CLI

qumod is the official command-line interface and automation runtime for Qumo Deploy. Built with TypeScript and compiled into standalone native executables, qumod enables engineers and AI coding agents to provision projects, manage credentials, and deploy edge relays without external runtime dependencies.

Key Capabilities

Standalone Binaries

Self-contained executables for macOS (Intel & Apple Silicon), Linux (amd64 & arm64), and Windows.

Interactive & Headless Auth

Seamless OAuth 2.0 Device Flow browser logins alongside QUMO_TOKEN headless CI authentication.

Full Command Suite

Manage deployments (deploy), projects (project list/create), and identities (whoami).

Agent & CI Ready

Structured --json output and strict exit codes designed for automated coding agents and CI runners.

Quick Example

# 1. Check current authenticated user and organization
qumod whoami

# 2. List projects in JSON for scripting
qumod project list --json

# 3. Trigger project deployment
qumod deploy --project my-stream-project

Documentation Index

Installation Guide — Download binaries and configure paths.
Authentication — Device flow vs. API keys and tokens.
Command Reference — Detailed argument and flag reference.
CI/CD & Coding Agents — GitHub Actions and AI automation recipes.