Installation

Prerequisites

• Node.js — Version 18 or later. Check with node --version.
• npm registry access — The CLI is published to npm, so you do not need GitHub access to install it.

Install globally

Using npm:

npm install -g @usemonoid/cli

Using pnpm:

pnpm add -g @usemonoid/cli

Run without installing

You can run the CLI once with npx:

npx @usemonoid/cli <command>

Example:

npx @usemonoid/cli whoami

How releases are published

The CLI is built from a private GitHub repository and published automatically to npm when the MONOid team pushes a tag named cli/vX.Y.Z and that tag matches the version in packages/cli/package.json.

GitHub releases may still show the tagged source snapshot. The installable CLI artifact is the npm package tarball, which only includes the packaged output.

Verify

After installing, confirm the CLI is available:

monoid --version

You should see a version number (e.g. 0.1.0).

Post-install

Before using resource commands, set up authentication. See Authentication.

If you plan to use the CLI from an AI agent or script, start your coding agent and ask it to use your installed MONOid CLI.

monoid setup-agent is available as an optional helper that prints environment and usage hints.