Compact by default
Ordinary commands return bounded plain text without JSON scaffolding, ANSI decoration, or repeated labels.
Local-first iCloud CLI
Control iCloud services with a command surface built for agents and humans.
icloud uses compact plain text by default, stable structured output when requested, and one public executable across local builds, npm installs, and release assets.
The current build establishes the command, output, help, completion, and man-page contract. It does not request credentials or contact iCloud yet.
CLI contract
Small outputs for routine decisions, explicit expansion for structured consumers.
Redirecting output does not switch formats. An agent receives the same compact default as a terminal user unless it deliberately asks for JSON.
Structured on request
Commands that support machine output expose an explicit --json success or error envelope with a request ID.
Safe for automation
Errors use stable exit classes, normal output stays on stdout, and diagnostics stay on stderr.
Self-documenting
The live command tree generates shell completions and man pages, keeping reference output aligned with the binary.
Available now
Inspect the build and generate local reference assets.
Install the package or build from source, then verify the exact binary with icloud version.
Inspect supported behavior with icloud capabilities before an agent chooses an output mode.
Generate completions for Bash, Zsh, Fish, or PowerShell directly from the installed command tree.
Generate a single root man page to stdout or the complete man-page tree into a directory.