Skip to main content
The Superserve CLI is the primary interface for deploying and managing AI agents on Superserve Cloud. The fastest way to install the CLI on macOS or Linux: 
curl -fsSL https://superserve.ai/install | sh
This script downloads the latest binary and adds it to your PATH.

​
Install via npm

If you have Node.js installed, you can install the CLI globally via npm: 
npm install -g @superserve/cli

​
Install via Homebrew

For macOS users with Homebrew: 
brew install superserve-ai/tap/superserve

​
Verify Installation

Confirm the CLI is installed correctly: 
superserve --version
You should see output like: 
1.1.0

​
Next Steps

Once installed, authenticate with Superserve Cloud: 
superserve login
See the Authentication page for details.

​
System Requirements

  • macOS: 10.15 or later
  • Linux: Any modern distribution with glibc 2.31+
  • Windows: WSL 2 required
  • Node.js (for npm install): 18.0.0 or later

​
Updating

​
Shell Install

Re-run the install script: 
curl -fsSL https://superserve.ai/install | sh

​
npm

npm update -g @superserve/cli

​
Homebrew

brew upgrade superserve

​
Uninstalling

​
Shell Install

Remove the binary from your PATH: 
rm $(which superserve)

​
npm

npm uninstall -g @superserve/cli

​
Homebrew

brew uninstall superserve

​
Global Options

The CLI supports these global options on all commands:
​
--version
flag
default:"false"
Display the CLI version number
​
--no-color
flag
default:"false"
Disable colored output in the terminal
​
--json
flag
default:"false"
Output results as JSON (supported on most commands)

​
Troubleshooting

​
Command Not Found

If superserve is not found after installation:
  1. Close and reopen your terminal
  2. Check your PATH includes the installation directory
  3. For npm installs, verify npm global bin is in your PATH:
echo $PATH | grep $(npm config get prefix)/bin

​
Permission Denied

If you see permission errors with npm: 
sudo npm install -g @superserve/cli
Or configure npm to use a user-owned directory for global packages.

Build docs developers (and LLMs) love

Get started for freeTalk to us