Agent Viewer Help Documentation

Agent Viewer is the web-based real-time observation panel for Hawa Code. Once enabled, it starts a local HTTP + WebSocket server, allowing you to view the running messages of the main Agent and each SubAgent in your browser in real time, with an experience consistent with the terminal CLI.

1. Enabling Agent Viewer

Method 1: Via the /config Configuration Interface

Enter /config in the Hawa Code REPL to enter the configuration interface.
Find the Web Server option and toggle it to on.
After the configuration is saved, the service will start automatically, and the terminal will print the access address, for example:
WebServer started at http://127.0.0.1:3210
Open this address in your browser to enter Agent Viewer.

Method 2: Directly Modify settings.json

Add a webServer configuration to the global settings.json:

{
  "webServer": {
    "enabled": true,
    "port": 3210,
    "host": "127.0.0.1"
  }
}

Configuration description:

Field	Type	Default	Description
`enabled`	boolean	`false`	Whether to enable the WebServer
`port`	number	`3210`	Listening port
`host`	string	`127.0.0.1`	Listening address; defaults to local access only

Restart Hawa Code, and the service will start automatically.

2. Interface Layout

The new version of Agent Viewer adopts a left-right split layout:

Left Sidebar: Displays the Hawa Code logo, a collapsible Agent tag list, running statistics, and a settings entry.
Right Main Content Area: The top contains the title bar and connection status, the middle contains the message list, and the bottom contains the Prompt input box.

Agent Viewer Main Interface

2.1 Left Sidebar

Element	Description
Collapse button (`≡` / `≫`)	Click to collapse or expand the sidebar; when collapsed, only the Agent status dot and settings icon are displayed.
Hawa Code title	The brand logo at the top of the sidebar.
Agent tag list	Lists the `main` Agent and all active SubAgents; click to switch.
Statistics	Displays the current total number of Agents and the number currently running, e.g., `Agents: 7 (0 active)`.
Settings button	Click to open the settings panel on the right.

2.2 Right Main Content Area

Element	Description
Title bar	Displays the current view name (`Agent Viewer` or `Settings`), message count, and WebSocket connection status.
Message list	Displays the current Agent’s dialogue messages, tool calls, execution results, thought processes, etc., in chronological order.
Auto-scroll resume button	After manually scrolling up to view history, click to resume automatic following to the bottom.
Prompt input box	Under the `main` Agent, you can directly input instructions and send them; supports plain text, slash commands (`/`), and Bash shortcut mode (`!`).

3. Multi-Agent Switching

When Hawa Code enables Agent Team or multi-Agent collaboration, the left Agent tag list displays all active Agents:

main: The main Agent, always present.
Other SubAgents: Display the Agent name and type, e.g., mcp-server-discovery (general), Explore, etc.
The dot color before the tag indicates the Agent status:
- Green: Executing (running / started)
- Gray: Ended (ended)

Click the corresponding tag to switch and view that Agent’s message stream.

4. Auto-scroll and Manual Pause

Auto-scroll is enabled by default; new messages will automatically follow to the bottom.
When you manually scroll up to view historical messages, auto-scroll will automatically pause.
After pausing, a Resume auto-scroll button appears above the message list; click to resume auto-scrolling.

5. WebSocket Real-time Connection

Agent Viewer maintains a long connection with the Hawa Code backend via WebSocket.
After the connection is disconnected, the frontend will automatically attempt to reconnect every 3 seconds.
Connection status is displayed in the top title bar:
- Connected: Connected
- Connecting...: Connecting
- Disconnected: Disconnected

6. Settings Panel

Click the Settings button in the left sidebar, and the right main content area will switch to the settings panel, supporting direct management of Hawa Code configuration in the browser:

The left side shows setting categories: General, Plugins, Web Server, Auto Mode, Memory, Model Config, Advanced.
The right side displays the configuration items under the corresponding category.
After modifying the configuration, click Save to save; click Reset to revert unsaved changes; click Close to close the settings panel and return to Agent Viewer.

Tip: After saving settings, some configuration items require restarting Hawa Code to take effect.

7. Prompt Input

Under the main Agent, the input box at the bottom can be used to send instructions to Hawa Code:

Plain text: Enter directly and press Enter to send.
Slash commands: Start with /, e.g., /config.
Bash shortcut mode: Start with ! to quickly execute Bash commands.
When the main Agent is executing, entered content will be queued; click the interrupt button on the right side of the input box to interrupt the current execution.
When switching to a SubAgent, the input box will prompt Switch to Main agent to type a prompt, and input is not possible at this time.

When an Agent executes a tool requiring permission confirmation (such as Bash, PowerShell, Write, Edit, etc.), a confirmation card will pop up on the page:

The top displays the tool name and pending count (when there are multiple confirmations, N pending is displayed).
The middle shows a summary of the command or file path, tool description, and risk level (Low / Medium / High).
The bottom provides the following options:
- Yes: Allow this execution.
- Yes, and don’t ask again…: Allow this time and do not ask again for similar operations during the current session.
- No, and tell Hawa Code what to do differently (esc): Deny execution and provide feedback.

Tip: When the page is in the background, Agent Viewer will attempt to send a browser system notification to avoid missing confirmation requests. When using it for the first time, you can click Enable notifications in the popup prompt to enable notification permissions.

9. User Interaction Response

When the Agent asks you questions via tools such as AskUserQuestion or EnterPlanMode, an interactive form is embedded directly in the message list. You can select options or enter content in the form and submit it, without needing to return to the CLI terminal. The submitted response will be synchronized to the Hawa Code backend.

10. Security Notes

The WebServer is bound to 127.0.0.1 by default, allowing only local access.
It is not recommended to modify host to 0.0.0.0 in a public network environment.
Dangerous operations in the tool confirmation popup will be marked with a risk level; please verify carefully before clicking allow.