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

# WebUI

> Run MiniMax Code Web locally and use your browser to give instructions, follow progress, and approve permissions.

MiniMax Code Web is the browser client for MiniMax Code. You open a local address in your browser and give instructions; the agent runs in a local process. Reading files, running commands, editing code, opening a browser, and permission approvals all happen on your own machine.

WebUI is a peer of the desktop app and the terminal client, not a web wrapper around either one. All three implement the same session protocol, so your account, session history, skills, plugins, memory, and scheduled tasks are the same wherever you open them.

> [!NOTE]
>
> WebUI is still evolving. Labels in the UI follow the version installed on your machine.

> [!NOTE]
>
> Screenshots on this page show the Chinese UI.

## What it's good for

| Scenario | Description |
| - | - |
| Remote development | Run WebUI on your laptop and give instructions, follow progress, and approve permissions from a browser |
| Watching long tasks | Let the agent run a long workflow and check changes, terminal output, and subtasks at any time |
| Reviewing changes | Read diffs in the workspace panel, review file by file, and undo or roll back a turn |
| Scheduled automation | Plan work in Scheduled Tasks; it runs on time and writes results back to the session |
| Working from your phone | After pairing the mobile app, add instructions, approve permissions, and check progress from your phone |
| One source for every client | Desktop, terminal, and browser share the same account, skills, plugins, memory, and scheduled tasks |

## Install and start

WebUI is a local service that only listens on `127.0.0.1`.

```bash theme={null}
npm install -g @minimax-webui/minimax-code --allow-scripts=better-sqlite3,node-pty,bufferutil,utf-8-validate
mcode-webui
```

`mcode-webui` uses port `2233` by default. To use another port, set the `WEBUI_SERVER_PORT` environment variable. The service only binds to loopback addresses and can't be exposed directly to the network.

## Open the page

Visit `http://127.0.0.1:2233/` in your browser. The page carries an access credential generated for this launch and uses it to connect to the local WebSocket service. The credential exists only in that page configuration and is never written to disk.

![WebUI home](https://mintcdn.com/agent-en/xNmZzH3iAXrG3Mfs/images/cli/webui/01-home.png?fit=max\&auto=format\&n=xNmZzH3iAXrG3Mfs\&q=85\&s=21d2c3df7c49526b6665e036a1202a25)

## Create your first task

1. On the home page, click **Select folder** and choose the project directory you want to work on. Sessions without a directory are grouped under **No project**.
2. Type a goal in the input box, for example "Get this repo running and fix the failing tests."
3. Click send. The agent reads files and runs commands in that directory. When an action needs permission, a confirmation appears above the input box; click approve.

## Core workflows

### Work modes

Switch in **Settings → General → Mode**:

| Mode | Characteristics | Best for |
| - | - | - |
| For development | Keeps technical details and developer tools | Writing code, changing projects, running tests, debugging pages |
| For everyday work | Same capability, fewer technical details | Documents, research, spreadsheets, office automation |

![Settings (General)](https://mintcdn.com/agent-en/xNmZzH3iAXrG3Mfs/images/cli/webui/08-settings.png?fit=max\&auto=format\&n=xNmZzH3iAXrG3Mfs\&q=85\&s=5444440803ddbcd52f5a1bc640ebf7be)

### Projects and sessions

Sessions are grouped by project directory. The agent can only see a directory's files, commands, and changes after you select it.

The left sidebar has New, Import session, workspace entries (Plugins, Scheduled Tasks, Apps, Remote), Pinned, and project groups. Account and settings are at the bottom.

| Action | Description |
| - | - |
| Import session | Import history from a session file |
| Pin | Keep important sessions at the top of the sidebar |
| Archive | Hide sessions you rarely use; find them again under Archived tasks |
| Search | Find past sessions or run commands by keyword |
| Quick navigation | Jump back to a specific turn in a long conversation |

### Permissions

The permission switch is at the bottom left of the input area:

| Mode | Behavior |
| - | - |
| Ask for approval (default) | Asks before each file write, command, or external action |
| Full access | Stops asking; use it in environments you already trust |

When the agent needs clarification it sends a questionnaire, and when it needs permission it shows a confirmation card. You answer both right in the conversation.

### Code review

There are three ways to review:

* Type `/` and choose the `code-review` command to review the whole repository.
* Click **Review** on a change card in a reply to see that turn's diff.
* Open the **Changes** tab in the workspace panel to review all changes by file, and undo or roll back a turn.

![Conversation and change card](https://mintcdn.com/agent-en/xNmZzH3iAXrG3Mfs/images/cli/webui/06-transcript.png?fit=max\&auto=format\&n=xNmZzH3iAXrG3Mfs\&q=85\&s=efca075ef3376938025591b20071469e)

Inline comments on selected text and reply feedback from the desktop app aren't available in WebUI yet. Write feedback directly in the conversation instead.

## Workspace panel

The workspace panel sits to the right of the conversation as a row of tabs. Each tab is a fixed slot whose content can be replaced in place: if you open a page in a new tab and then navigate elsewhere, it stays the same tab.

| Tab | Purpose |
| - | - |
| Files | Browse the workspace file tree and preview files |
| Changes | The current change set: per-file diffs, review, and rollback |
| Terminal | Open a terminal in the project directory |
| Canvas | An infinite canvas where image, video, and text nodes can be arranged and connected |
| Web | Pages opened in the built-in browser, with back and forward |
| Apps | Pages of installed Mini Apps |

A new tab offers five entries (Changes, Terminal, Canvas, Apps, Files) and an address bar for typing a URL.

![Workspace panel](https://mintcdn.com/agent-en/xNmZzH3iAXrG3Mfs/images/cli/webui/07-workspace-panel.png?fit=max\&auto=format\&n=xNmZzH3iAXrG3Mfs\&q=85\&s=4af2f425885ba05f468df4c60c258280)

### Built-in browser

Choose from three browsers: the isolated browser (default, a separate in-process environment), Microsoft Edge, or Google Chrome. Edge and Chrome need authorization in settings first; after that the agent can operate real browser pages.

### Appearance and shortcuts

**Settings → General → Appearance** switches between light, dark, and system. The personalization page has theme settings, and the shortcuts page lets you view and rebind input shortcuts.

## Agent capabilities

* **Goal**: Use `/目标` (Goal) to give the agent a verifiable end goal. It keeps going until the goal is met or it gets blocked.
* **Agent Team and custom agents**: Team mode splits work across several agents that check each other. In plugin management you can assign an agent to run a specific plugin.
* **Mini Apps**: **Apps** lists the Mini Apps available on this machine; click one to open it in a tab on the right.
* **Plugins and skills**: **Plugins** has two tabs, Plugins and Skills. Browse plugins by category, see install status on each card, or import a plugin from a GitHub repository.
* **MCP servers**: Connect external tools and data sources in plugin management. Local stdio and remote HTTP transports are supported; HTTP lets you set headers, parameters, and more.
* **Memory**: Maintain memory and global instructions in settings. Memory keeps long-term preferences and project conventions; global instructions apply to every session.

![Plugins and skills](https://mintcdn.com/agent-en/xNmZzH3iAXrG3Mfs/images/cli/webui/02-plugins.png?fit=max\&auto=format\&n=xNmZzH3iAXrG3Mfs\&q=85\&s=4b9c4d72a6aa72015a1810fb7f562766)

![Mini App list](https://mintcdn.com/agent-en/xNmZzH3iAXrG3Mfs/images/cli/webui/04-mini-apps.png?fit=max\&auto=format\&n=xNmZzH3iAXrG3Mfs\&q=85\&s=13f9a57079222a8b786128f30ab9c40f)

## Automation and remote

### Scheduled tasks

Tasks run on schedule and write results back to their session. Four templates are built in:

| Template | Description |
| - | - |
| Daily summary | Review project progress and to-dos at the end of the day |
| Weekly plan | Lay out the week's priorities at the start of the week |
| Periodic project check | Check code changes on a schedule and summarize what needs attention |
| One-time reminder | Create a scheduled task for a single item |

When editing a task you set its name, request, and the agent that runs it. The list shows upcoming tasks and past runs.

![Scheduled tasks](https://mintcdn.com/agent-en/xNmZzH3iAXrG3Mfs/images/cli/webui/03-schedule.png?fit=max\&auto=format\&n=xNmZzH3iAXrG3Mfs\&q=85\&s=7cc44a2737e1b97e4a02351b6bf38ded)

### Remote control and IM

The **Remote** page has two tabs:

* **Remote control**: Pair with the mobile app. The pairing code is single-use, never written to disk, and never sent back to the browser. After the service restarts it reconnects on its own, so you don't need to pair the phone again.
* **IM**: Bind IM channels such as Feishu or WeChat to the local agent. You can then give tasks, see results, and approve permissions from chat. Channel status and message filter rules are managed here too.

![Remote control and IM](https://mintcdn.com/agent-en/xNmZzH3iAXrG3Mfs/images/cli/webui/05-remote.png?fit=max\&auto=format\&n=xNmZzH3iAXrG3Mfs\&q=85\&s=a622300ae8f7ec2f0aab5624c94d2d42)

## Models and account

* **Usage**: **Settings → Usage & Models** shows quotas such as the 5-hour limit, weekly limit, and video limit, plus context window usage. The account menu has a daily check-in; consecutive check-ins earn points.
* **Models**: Use MiniMax-hosted models, or connect your own model source with a Base URL, API key, and model name. Candidate model discovery and connectivity tests are supported.

## Differences from the desktop app

| Capability | WebUI | Notes |
| - | - | - |
| Device-to-cloud task handoff | Not supported | Cloud sessions and handoff are desktop features |
| Inline comments / reply feedback | Not supported | Desktop feature |
| Change graph | Not supported | The desktop workspace panel shows commit history and branches |
| Quick window | Not applicable | Desktop only |
| App self-update | Not applicable | Upgrade through the npm package |
| Computer use | Available as a plugin | "Computer Use" in the plugin marketplace |
| Voice input | Not available yet | The voice settings page is disabled |
| Data directory migration | Not supported | The location is shown only |
| Naming web tabs | Isolated browser only | Edge / Chrome pages can't be named |

### Known limitations

* Some services are desktop-only, and WebUI hides their entries.
* The progress panel is unavailable when the window is narrower than 1080px.
* When the sidebar is collapsed, navigation items aren't shown.

## FAQ

**The page keeps showing "Loading projects and sessions"?**

The service usually isn't ready or the connection was refused. Check the connection indicator in the status bar at the bottom left; refreshing the page fetches a new credential.

**The agent says no model is available?**

Check the model source and credentials in **Settings → Usage & Models**.

**Can't find a feature?**

Some capabilities sit behind a switch. Check authorization and enablement in **Settings → Browser** or on the plugin and MCP pages.

**Can I access it from another machine?**

The service only listens on loopback. To reach it from another machine, set up your own secure port forwarding or tunnel. Don't expose it directly to the internet.

**Can it share an account with the terminal client?**

Yes. The data directory `~/.minimax` (override with `MINIMAX_DATA_DIR`) shares the same login, skills, and plugins with the CLI.

## Quick reference

| Item | Value |
| - | - |
| Start command | `mcode-webui` |
| Default address | `http://127.0.0.1:2233/` |
| Port override | `WEBUI_SERVER_PORT` |
| Data directory | `~/.minimax` (override with `MINIMAX_DATA_DIR`) |