> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nagare.smtdfc.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Web UI

> Open the web UI, log in with a token, and manage conversations with Nagare.

The web UI is the main way to chat and configure Nagare. The desktop app `nagare-desktop` uses the same interface.

## Open the web UI

Make sure the gateway is running (`nagare gateway start`), then run:

```bash theme={null}
nagare web
```

By default, this command:

* Serves the UI at `http://127.0.0.1:3005`.
* Creates a new login token.
* Opens the browser at a URL with `gateway` and `token` pre-filled, so you are logged in immediately. The UI removes these parameters from the address bar after saving.

Common options:

```bash theme={null}
# Change the web UI port
nagare web --addr 127.0.0.1:8080

# Only print the login URL, do not open the browser
nagare web --no-open

# Connect to a gateway at a different address
nagare web --gateway http://192.168.1.10:9832
```

See the full reference at [CLI Reference](https://docs.nagare.smtdfc.net/en/reference/cli.md#nagare-web).

## Manual login

If you open the UI without being logged in:

1. Create a token:
   ```bash theme={null}
   nagare auth token
   ```
2. Go to `http://127.0.0.1:3005` and paste the token into the login box.
3. If the gateway is not running at the default address, click **Advanced** to enter the gateway URL.

> [!NOTE]
>
> The token is a JWT valid for **60 hours**. When it expires, create a new token with `nagare auth token`.

## Chat

Each conversation is a **session** with its own title, model, and history. In the UI, you can:

| Action | Description |
| - | - |
| New session | Start a new conversation with the default model. |
| Switch model | Select a different provider and model for the current session only. |
| Cancel | Stop the response being generated. |
| Compact | Summarize a long conversation to reduce context sent to the model. Uses the **Summary model** if configured, otherwise uses the conversation model. |
| Duplicate | Create a copy of the session. |
| Archive | Hide the session from the main list without deleting it. |
| Delete | Delete the session and its history. |

Responses are streamed in real time via WebSocket.

## Tool approval

When Nagare wants to run a risky tool (for example, delete a file, shut down the machine, or terminate a process), the UI displays an approval request. Click accept to allow or reject to cancel. See [Tools](https://docs.nagare.smtdfc.net/en/guides/tools.md#tool-approval).

## Settings pages

| Page | Content |
| - | - |
| **General** | Default model and summary model. |
| **Model providers** | Add, view, and remove model providers. |
| **Credentials** | Save API keys for reuse across multiple providers. |
| **Plugins** | Install, update, enable/disable, and remove plugins, and view their status. |

See [Model Providers](https://docs.nagare.smtdfc.net/en/guides/model-providers.md) and [Plugin Overview](https://docs.nagare.smtdfc.net/en/plugins/overview.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.