Reference
Changelog
Release notes and unreleased user-visible changes for icloud.
Unreleased
- Added offline multi-account setup with stable IDs, case-insensitive name/email uniqueness, first-account defaulting, deterministic selection, rename/default/remove commands, and
pending_validationstatus. - Added native keyring credential storage and rotation plus first-class environment and file references; no plaintext credential is stored in SQLite or returned in compact/JSON output.
- Added secure terminal and
--password-stdininput without a public--passwordflag, explicit non-TTY behavior, bounded secret input, and redacted keyring/reference failures. - Added credential metadata, replace, and delete commands; destructive account/credential operations require
--yes, and default-account removal is protected while alternatives remain. - Added cross-process account mutation locking and keyring rollback/cleanup around failed database transactions.
- Added the account setup and credentials guide and updated quickstart, installation, local-state, automation, troubleshooting, command reference, landing page, and README for the Phase 3 workflow.
- Added durable local application paths with
--home,ICLOUD_HOME, and platform-default resolution. - Added private first-run state creation, automatic versioned upgrades, cross-process locking, and a reported data-schema version.
- Added
icloud account listandicloud account showwith compact defaults, explicit JSON envelopes, typed not-found/conflict exits, and credential-reference redaction. - Added stable prefixed account identifiers and the initial account/credential-reference state contract without storing plaintext credentials.
- Added the local-state and account-inspection guide plus updated installation, quickstart, automation, troubleshooting, command reference, and homepage content.
- Replaced the placeholder command with the public
icloudexecutable across Go builds, npm installation, project metadata, and release automation. - Added grouped Cobra help, compact
versionandcapabilitiescommands, explicit JSON envelopes, request IDs, stable error classes, and deterministic stdout/stderr behavior. - Added Bash, Zsh, Fish, and PowerShell completion generation.
- Added root and full-tree man-page generation from the live command tree.
- Added bounded compact-output golden tests and packaging checks for all supported release targets.
- Replaced the starter documentation with installation, quickstart, automation, troubleshooting, and current command-reference guides.
0.1.0 — 2026-08-05
- Published the initial repository scaffold, npm wrapper, release workflow, and documentation site before iCloud-specific command implementation began.