Skip to main content

Prerequisites

Before using QAOS, make sure you have: Verify your Node.js version:
node --version
# v18.0.0 or higher recommended
npx is included with Node.js — no separate installation needed.

Run without installing

You can run QAOS directly using npx without installing anything globally:
npx qaos --version
npx will download the latest version of the CLI on first use and cache it locally.

Install globally (optional)

If you prefer to have qaos available as a standalone command, you can install it globally:
npm install --global qaos
After that, you can run qaos directly instead of npx qaos.

Update

To run the latest version with npx, use the @latest tag:
npx qaos@latest --version
If you installed globally, update with:
npm install --global qaos@latest

Uninstall

If you installed QAOS globally and want to remove it:
npm uninstall --global qaos
If you only used npx, there is nothing to uninstall — npx caches are managed by npm automatically.

Troubleshooting

If you are using npx, make sure you are running npx qaos and not just qaos. If you installed globally and the command is not found, your npm global bin directory may not be in your PATH. Run:
npm bin -g
Add the printed path to your shell’s PATH variable (.bashrc, .zshrc, or equivalent).
QAOS requires Node.js 16 or later. Update using nvm:
nvm install --lts
nvm use --lts

Next steps

Once ready, authenticate your CLI to connect it to your QAOS account.