Web UI

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:

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:

# 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. If you open the UI without being logged in:

Create a token:
nagare auth token
Go to http://127.0.0.1:3005 and paste the token into the login box.
If the gateway is not running at the default address, click Advanced to enter the gateway URL.

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.

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 and Plugin Overview.

Getting started

User guides

Plugin development

Reference

Open the web UI

Chat

Tool approval

Settings pages

​Open the web UI

​Manual login

​Chat

​Tool approval

​Settings pages

Open the web UI

Manual login

Chat

Tool approval

Settings pages