Installation
Install the Aucert CLI globally using your preferred package manager.
- npm
- yarn
- pnpm
npm install -g @aucert/cli
yarn global add @aucert/cli
pnpm add -g @aucert/cli
Verify installation
aucert --version
# Expected: @aucert/cli/x.y.z
System requirements
| Requirement | Minimum | Notes |
|---|---|---|
| Node.js | 20 LTS or later | Required for the CLI runtime |
| OS | macOS, Linux, Windows (WSL) | Native Windows is not supported — use WSL 2 |
| Android SDK | Latest stable | Required for local emulator execution |
| Disk space | 500 MB | For CLI, cached models, and test artifacts |
Windows users: Aucert requires WSL 2 (Windows Subsystem for Linux). Native Windows command prompt and PowerShell are not supported. Install WSL 2, then install Node.js and the CLI inside your WSL environment.
Authentication
After installation, authenticate with your Aucert account:
aucert auth login
This opens a browser window for OAuth authentication. After completing the flow, your credentials are stored securely in ~/.config/aucert/credentials.json.
Verify authentication
aucert auth whoami
# Expected: Logged in as user@example.com (org: your-org)
CI/CD authentication
For non-interactive environments (CI pipelines), authenticate with an API token.
export AUCERT_API_TOKEN=your-token-here
aucert auth verify
Generate API tokens from your Aucert dashboard.
Troubleshooting
Permission denied: EACCES
Cause: npm global installs require write access to the global node_modules directory.
Fix: Use a Node version manager (recommended) or fix npm permissions:
# Option 1: Use nvm (recommended)
nvm install 22
nvm use 22
npm install -g @aucert/cli
# Option 2: Fix npm prefix
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
npm install -g @aucert/cli
Command not found: aucert
Cause: The global npm bin directory is not in your PATH.
Fix:
# Find where npm installed it
npm list -g --depth=0
# Add the bin directory to your PATH
export PATH=$(npm config get prefix)/bin:$PATH
# Make it permanent (add to ~/.bashrc or ~/.zshrc)
echo 'export PATH=$(npm config get prefix)/bin:$PATH' >> ~/.zshrc
What's next
- First test — Run your first AI-powered test
- Configuration — Customize Aucert for your project