Install via npm

Install CloudCLI UI globally with npm so you can start it with a single command from anywhere on your machine.

Install via npm

Installing CloudCLI UI globally with npm gives you a single short command to start it from any directory.

Before continuing, make sure you've covered the Prerequisites.

Install

bash

npm install -g @siteboon/claude-code-ui

Start

bash

cloudcli

The server starts at http://localhost:3001 by default.

CLI Reference

Command	Description
`cloudcli`	Start the server
`cloudcli start`	Start the server explicitly
`cloudcli status`	Show configuration and data locations
`cloudcli update`	Update to the latest version
`cloudcli version`	Show version information
`cloudcli help`	Show help
`cloudcli -p 8080`	Start on a custom port

Updating

bash

cloudcli update

Uninstalling

bash

npm uninstall -g @siteboon/claude-code-ui

Running as a Background Service

For always-on access where CloudCLI UI keeps running even when your terminal is closed and restarts automatically on machine reboot, use PM2.

Install PM2

bash

npm install -g pm2

Start as a Background Service

bash

pm2 start cloudcli --name "cloudcli-ui"

To start on a custom port:

bash

pm2 start cloudcli --name "cloudcli-ui" -- --port 8080

Auto-Start on System Boot

bash

pm2 startup
pm2 save

PM2 will output a command to run — copy and run it to complete the setup.

Useful PM2 Commands

Command	Description
`pm2 list`	Show all running services
`pm2 logs cloudcli-ui`	View logs
`pm2 stop cloudcli-ui`	Stop the service
`pm2 restart cloudcli-ui`	Restart the service
`pm2 delete cloudcli-ui`	Remove from PM2

Note: Running CloudCLI UI in the background keeps the UI server alive, not your agent sessions. If you want agent sessions that persist independently of your machine, see CloudCLI Cloud.

Configuration

For a globally installed CLI, environment variables are set in your shell profile rather than a .env file. See the Configuration guide for all available options and how to set them.