@paean-ai/zero-gui
v0.3.6
Published
Local browser GUI for controlling Zero CLI sessions via WebSocket
Readme
Zero GUI
Local browser-based GUI for controlling Zero CLI sessions.
Quick Start
npx @paean-ai/zero-guiThen in your Zero CLI session, run:
/guiOpen http://localhost:7300 in your browser to interact with your CLI sessions through a modern chat interface.
Features
- Multi-session management — Connect and manage multiple Zero CLI sessions from a single browser tab
- Remote file tree — Browse the CLI's working directory, expand folders, and drag files into the chat as context
- File context attachments — Add files from the file tree to your message; their content is sent as context to the CLI agent
- Image attachments — Paste, drag-and-drop, or attach images (JPEG, PNG, GIF, WebP) to your messages
- Streaming responses — See assistant responses as they stream in real-time
- Syntax highlighting — Code blocks in assistant responses are highlighted with language-aware coloring
- Tool call visualization — See tool calls and their status as the assistant works, with collapsible sections
- Markdown rendering — Rich message display with code blocks, tables, links, and formatting
- Auto-reconnect — Automatic reconnection if the WebSocket connection drops
- 3-column layout — Left sidebar (sessions), center (chat), right panel (file tree) with collapsible panels
Configuration
| Option | Default | Description |
|--------|---------|-------------|
| ZERO_GUI_PORT | 7300 | Server port |
Development
git clone https://github.com/a8e-ai/zero-gui.git
cd zero-gui
npm install
npm run devThis starts both the Express server and Vite dev server with hot reload.
Architecture
Browser ←→ WebSocket ←→ zero-gui server ←→ WebSocket ←→ Zero CLIThe server acts as a relay between browser clients and CLI sessions. The file tree panel communicates with the CLI's file system through the same WebSocket channel, with path-traversal protection ensuring only files within the CLI's working directory are accessible. All communication happens locally on your machine — no data leaves localhost.
License
MIT
