scream-code 0.10.9 → 0.10.11

package/README.md

@@ -90,6 +90,7 @@ npm install -g scream-code
 After installation, the `scream` command is added to PATH. First install takes about 2-5 minutes.
 
 - Start TUI: `scream`
+- Start Web UI: `scream web`
 - Auto-permission mode: `scream --auto`
 - Auto-approve mode: `scream -y`
 - Switch language after startup: `/language`
@@ -115,6 +116,7 @@ When it needs to modify files or run commands, an approval panel appears. Press
 | Feature | Description |
 |---------|-------------|
 | 💬 **Conversational Interaction** | Describe what you need in natural language — it writes code, edits files, runs commands |
+| 🌐 **Web UI** | `scream web` — browser-based chat with multi-session, model switching, and full TUI parity |
 | 🔒 **Security First** | Must get approval before modifying files; `.env` and sensitive files are blocked by default |
 | 🛡️ **Permission Engine** | Fine-grained control over read/write/execute permissions |
 | ⚙️ **State Machine** | Prevents drift, enforces task granularity, reduces token waste |
@@ -133,6 +135,29 @@ When it needs to modify files or run commands, an approval panel appears. Press
 
 ---
 
+## 🌐 Web UI — Browser-Based Chat
+
+Launch the web interface with `scream web` — no terminal required. Full TUI parity in your browser.
+
+```bash
+scream web              # Start on default port 3210
+scream web --port 3222  # Custom port
+scream web -y           # Auto-approve mode
+scream web --auto       # Auto permission mode
+scream web --no-open    # Don't auto-open browser
+```
+
+**Features:**
+- 💬 **Full chat experience** — same agent-core as TUI, zero feature loss
+- 📂 **Multi-session** — sidebar with create/switch/delete/export, persistent across restarts
+- 🔄 **Model switching** — click model pill to switch models and thinking levels
+- ⌨️ **Slash commands** — `/compact` `/auto` `/yes` `/plan` `/fork` `/title` `/status` `/usage` `/btw` and more
+- 🎨 **Themes** — light/dark/system with smooth transitions
+- 📱 **Mobile responsive** — works on phones and tablets
+- 🔒 **Local only** — binds to 127.0.0.1, no external access
+
+---
+
 ## 📱 cc-connect — Remote Control via Chat
 
 Supports WeChat, Feishu, Slack, DingTalk, QQ, Telegram, and more. Install cc-connect after scream-code to control it remotely.
@@ -266,6 +291,7 @@ npm install -g scream-code
 
 安装完成后，`scream` 命令自动加入 PATH。首次安装约需 2-5 分钟。
 TUI启动命令`scream`
+Web网页端启动命令`scream web`
 自动权限模式启动`scream --auto`
 自动批准模式启动`scream -y`
 启动后切换语言`/language`
@@ -294,6 +320,7 @@ TUI启动命令`scream`
 | 功能 | 说明 |
 |------|------|
 | 💬 **对话式交互** | 用自然语言描述需求，它自动写代码、改文件、跑命令 |
+| 🌐 **Web网页端** | `scream web` 启动浏览器聊天，支持多会话、模型切换，与TUI功能对齐 |
 | 🔒 **安全第一** | 修改文件前必须征得同意，`.env` 等敏感文件默认禁止操作 |
 | 🛡️ **权限引擎** | 精细控制它能做什么（读取/写入/执行），防止误操作 |
 | ⚙️ **状态机机制** | 防漂移，强化任务颗粒度，不出错，任务完成度高，降低 Token 消耗 |
@@ -312,6 +339,29 @@ TUI启动命令`scream`
 
 ---
 
+## 🌐 Web网页端 — 浏览器聊天
+
+输入 `scream web` 启动网页端，无需终端，浏览器里直接使用。功能与TUI完全对齐。
+
+```bash
+scream web              # 默认端口 3210
+scream web --port 3222  # 自定义端口
+scream web -y           # 自动批准模式
+scream web --auto       # 自动权限模式
+scream web --no-open    # 不自动打开浏览器
+```
+
+**功能特性：**
+- 💬 **完整聊天体验** — 与TUI共用同一套 agent-core，功能零损失
+- 📂 **多会话管理** — 左侧栏新建/切换/删除/导出会话，重启后自动恢复
+- 🔄 **模型切换** — 点击模型标签即可切换模型和思考强度
+- ⌨️ **斜杠命令** — `/compact` `/auto` `/yes` `/plan` `/fork` `/title` `/status` `/usage` `/btw` 等
+- 🎨 **主题切换** — 亮色/暗色/跟随系统，平滑过渡
+- 📱 **移动端适配** — 手机平板也能用
+- 🔒 **仅本地访问** — 绑定 127.0.0.1，外部无法访问
+
+---
+
 ## 📱 cc-connect 通过聊天远程控制
 
 支持微信、飞书、Slack、钉钉、QQ、Telegram 等，你可以在安装 scream-code 后一键安装 cc-connect 来控制你的 screamcode。