SiteOS CLI

Search supports independent indices per Project environment. Use search index list/create and pass --index ID to subsequent hosted Search operations. Named-index --install writes distinct credential variables and reports their names in safe installation metadata; do not overwrite another index's variables. See the Search skill's index workflow.

Read the shared execution contract once per task before choosing tools or resolving context, including when this skill is invoked directly. Apply the service-specific workflow below after that shared contract.

Use the single public package and binary:

npx --yes @siteoshq/cli@latest --help
npm install --global @siteoshq/cli
siteos --version

Node.js 22 or newer is required. Confirm the executable version and the needed subcommand in the task's working directory. A newer installation elsewhere does not update a different siteos resolved by PATH.

If a command is missing, use command -v siteos (or Get-Command siteos on PowerShell) and siteos --version, then run npx --yes @siteoshq/cli@latest --version and the needed --help. Keep the working directory, origin and SITEOS_HOME unchanged and use that same verified invocation for subsequent commands. Bare npx @siteoshq/cli may resolve an older local installation. If npm reports cache EACCES, pass --cache <new-user-owned-temporary-directory> to npm/npx and keep it for this task; do not use sudo or change ownership of the shared cache as part of a file workflow.

Run npx --yes @siteoshq/cli@latest health-check --json for read-only local diagnostics. It reports CLI/repository/reference readiness without contacting product APIs or reading runtime credentials.