> ## Documentation Index
> Fetch the complete documentation index at: https://toolkit.astralsolutions.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# toolkit ui — Launch the Interactive Web Dashboard UI

> toolkit ui starts the embedded web server and opens the React dashboard at http://toolkit.localhost, with options to set a custom port or skip auto-open.

`toolkit ui` starts the embedded web server that powers the Toolkit React dashboard and, by default, opens it in your browser automatically. The dashboard gives you a visual alternative to the CLI — you can inspect running proxy routes, manage ports, and control the daemon without typing a single command. When you run `toolkit ui`, it also starts the proxy daemon in the background if it isn't already running, so your `*.localhost` routes are immediately active.

***

## Syntax

```bash theme={null}
toolkit ui [options]
```

***

## Options

| Option             | Type    | Default | Description                                               |
| :----------------- | :------ | :------ | :-------------------------------------------------------- |
| `-p, --port <num>` | number  | `3100`  | The local port the UI web server binds to.                |
| `--no-open`        | boolean | —       | Disable automatic browser launch after the server starts. |

***

## Examples

```bash theme={null}
# Start the dashboard and open it in your default browser
toolkit ui

# Start the dashboard on a custom port
toolkit ui --port 3200

# Start the dashboard on a custom port without opening the browser
toolkit ui --port 3200 --no-open
```

***

## Accessing the dashboard

Once `toolkit ui` is running, the dashboard is reachable at two URLs:

| URL                        | Description                                                                                                                                                              |
| :------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `http://toolkit.localhost` | The named proxy URL — available when the proxy daemon is active and port `80` is free. This is the primary access point.                                                 |
| `http://localhost:3100`    | The direct loopback URL — always available regardless of whether the proxy is running. Useful as a fallback or in environments where the proxy cannot bind to port `80`. |

If you started the UI on a non-default port with `--port`, replace `3100` in the direct URL with the port you chose.

<Note>
  `toolkit ui` automatically starts the background proxy daemon if it isn't already running. You don't need to run `toolkit daemon` separately before launching the UI.
</Note>