Installation

Install the dcupl CLI once and run it from any directory, or invoke it on demand with npx. This page covers both approaches, the Node.js requirement, and how to confirm everything works.

Prerequisites

  • Node.js 20.19.1+ — check with node -v
  • A package manager (npm or pnpm)

Install

Install globally to make the dcupl binary available everywhere, or use npx to run the CLI without installing it.

npm install -g @dcupl/cli
npx @dcupl/cli <command>
# e.g. npx @dcupl/cli version

Verify

Confirm the install and inspect the resolved package versions:

dcupl version

dcupl version prints the CLI version along with the resolved @dcupl/* package versions it bundles (@dcupl/core and @dcupl/loader). This is the quickest way to confirm the binary is on your PATH and to check exactly which engine versions you are running.

Credentials aren't needed to install or scaffold a project. You configure them later with dcupl config set — see Cloud Sync.

Troubleshooting

dcupl: command not found

After a global install, your shell may not find the binary because npm's global bin directory isn't on your PATH.

# Show where global packages are installed
npm config get prefix
# Ensure <prefix>/bin is on your PATH, then restart your shell

As a workaround, run the CLI without installing:

npx @dcupl/cli version

Node version too old

The CLI requires Node.js 20.19.1 or newer. Check your version and upgrade if needed:

node -v
# If below 20.19.1, install a newer Node.js (e.g. via nvm or fnm)

Next Steps