Local Development Setup

Clone and run CloudCLI UI locally with hot reload for contributing or development.

Local Development Setup

Use this guide if you want to contribute to CloudCLI UI, build on top of it, or run the very latest changes from the repository before they are published to npm.

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

Clone the Repository

bash

git clone https://github.com/siteboon/claudecodeui.git
cd claudecodeui

Install Dependencies

bash

npm install

Configure Environment

bash

cp .env.example .env

Open .env and set your preferred port and any other options.

Start in Development Mode

bash

npm run dev

The app starts with hot reload at the port configured in your .env file (default http://localhost:3001).

Because you are running directly from the repository, you always have the most recent changes — including features and fixes that have not yet been released to the npm package. If you want to stay on the cutting edge, pull regularly:

bash

git pull origin main
npm install

Contributing

See the Contributing Guide for commit conventions, branch naming, and the pull request process.