Quick Start (npx)

The fastest way to run CloudCLI UI locally with no installation required. One command and you're up and running.

Quick Start (npx)

The fastest way to get CloudCLI UI running on your machine. No installation required — just run the command and you're up.

npx always fetches the latest published version, so you'll never be running outdated code.

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

Run CloudCLI UI

bash

npx @siteboon/claude-code-ui

The server starts and is accessible at:

http://localhost:3001

CloudCLI UI automatically discovers all your existing sessions from your ~/.claude folder. Any sessions you create via the UI are immediately available when you run claude -r in your terminal too.

Custom Port

If port 3001 is already in use:

bash

npx @siteboon/claude-code-ui --port 8080

Restarting

Stop the server with Ctrl+C and run the same command again.

Access From Your Phone

Once the server is running, open http://[your-machine-ip]:3001 in any browser on the same network. No VPN or tunnel required.

To find your machine's local IP:

bash

# macOS / Linux
ifconfig | grep 'inet '

# Windows
ipconfig

Next Steps

For frequent use, consider a Global Installation so you can start CloudCLI UI with a single short command. For production or always-on setups, see Running as a Background Service.