docs: refocus readme around demo and supervisor workflows

Author: pallyoung

README.md

@@ -4,63 +4,32 @@
 
 # Coder Studio
 
-</div>
-
-<div align="center">
+**A browser-based AI coding workspace for developers who move between desktop, tablet, and phone.**
 
-**AI Coding Workspace · Browser-Based · Cross-Device · Self-Hosted**
+Run Claude Code and Codex in one workspace. Keep your terminal, files, Git view, and AI sessions available from any device.
 
 [![npm version](https://img.shields.io/npm/v/@spencer-kit/coder-studio.svg)](https://www.npmjs.com/package/@spencer-kit/coder-studio)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D24.0.0-green.svg)](https://nodejs.org/)
 [![GitHub Stars](https://img.shields.io/github/stars/spencerkit/coder-studio?style=social)](https://github.com/spencerkit/coder-studio/stargazers)
-[![GitHub Discussions](https://img.shields.io/github/discussions/spencerkit/coder-studio)](https://github.com/spencerkit/coder-studio/discussions)
-[![Open Issues](https://img.shields.io/github/issues/spencerkit/coder-studio)](https://github.com/spencerkit/coder-studio/issues)
-[![Contributors](https://img.shields.io/github/contributors/spencerkit/coder-studio)](https://github.com/spencerkit/coder-studio/graphs/contributors)
-
-</div>
-
----
-
-> Deploy once, code everywhere.
->
-> Deploy your coding workspace once, then keep working anywhere.
 
-[中文说明](README.zh-CN.md) | [Documentation](docs/help/quick-start.md) | [GitHub](https://github.com/spencerkit/coder-studio)
+[Watch Demo](docs/assets/demo.mp4) · [Quick Start](#quick-start) · [Star on GitHub](https://github.com/spencerkit/coder-studio)
 
-**Coder Studio** is a browser-based AI coding workspace that runs on your local machine. Access your development environment from any device with a web browser — continue coding on your phone during commute, review changes on a tablet, or switch between computers seamlessly.
-
-## ✨ Key Features
-
-- 🌐 **Browser-Based Workspace** — No desktop app needed, works in any modern browser
-- 📱 **Cross-Device Continuity** — Start on desktop, continue on mobile, switch devices freely
-- 🤖 **Multi-Agent Support** — Run Claude Code and OpenAI Codex sessions side by side
-- 🔧 **Integrated Environment** — Terminal, file editor, Git viewer, and AI agents in one interface
-- 🔒 **Self-Hosted & Private** — Code stays on your machine, no cloud IDE dependency
-- ⚡ **Real-Time Sync** — Live workspace state across all connected devices
-
-![Workspace Overview](docs/help/assets/screenshot-workspace-overview.png)
-
-[![Watch Demo Video](docs/assets/demo-poster.png)](docs/assets/demo.mp4)
-
-<div align="center">Watch the recorded demo video</div>
+[中文说明](README.zh-CN.md) | [Documentation](docs/help/quick-start.md)
 
+</div>
 
----
+[![Watch Demo Video](docs/assets/demo-preview.gif)](docs/assets/demo.mp4)
 
-## 🎯 Why Coder Studio
+<div align="center">See how one coding workspace follows you from desktop to mobile without losing context.</div>
 
-| Feature | Benefit |
-|---------|---------|
-| **Deploy once, continue anywhere** | Start the service once, move between devices without breaking flow |
-| **Unified workspace** | Agent, code, Git, and terminal in one place — no more app switching |
-| **Multi-Agent support** | Run Claude Code and Codex sessions side by side |
-| **Local-first & private** | Runs on your machine, code never leaves your device |
-| **Zero-config browser access** | No desktop client, just open a URL from any device |
+## Why It Feels Different
 
----
+- **One browser workspace for AI coding** — Keep terminal, files, Git, and AI sessions in one place.
+- **Built for device switching** — Start on desktop, continue on tablet, and check progress from your phone.
+- **Objective-driven multi-step orchestration** — Let Supervisor steer long-running AI tasks so you do not have to babysit every turn, reduce repetitive manual prompting, and get more consistent outcomes.
 
-## 🚀 Quick Start
+## Quick Start
 
 ```bash
 # Install globally
@@ -78,23 +47,23 @@ Your browser opens automatically. Select your project folder and start working w
 
 ## 💡 Use Cases
 
-### Remote-Friendly Development
+### Cross-Device Development
 
 - Start an Agent task at the office, check progress on your phone during commute
 - Review code changes on a tablet without opening your laptop
 - Continue work from a home computer with zero setup
 
-### Team Collaboration
+### Long-Running AI Workflows
 
-- Share workspace URL with teammates on the same network
-- Code review without screen sharing — just open the link
-- Real-time visibility into Agent progress for stakeholders
+- Let Supervisor push multi-step tasks toward an objective without constant babysitting
+- Check evaluation cycles and follow-up actions from your phone instead of watching terminal output
+- Reduce repetitive prompting and manual coordination during long agent runs
 
 ### AI-Assisted Coding
 
-- Run multiple Claude Code or Codex sessions in parallel
-- Monitor Agent progress from mobile while away from desk
-- Keep terminal, editor, and Git view in one unified interface
+- Run Claude Code and Codex sessions side by side
+- Keep terminal, editor, Git, and supervisor state in one unified interface
+- Resume active AI work from another device without rebuilding context
 
 ---
 
@@ -122,13 +91,13 @@ The same workspace URL works across all devices — interface adapts automatical
 
 | Feature | Description |
 |---------|-------------|
-| **Multi-Agent Sessions** | Run Claude Code and Codex sessions side by side |
-| **Integrated Editor** | Monaco-powered code editor with syntax highlighting |
-| **Git Integration** | View branches, diffs, and changed files without leaving workspace |
-| **Shell Terminal** | Full PTY terminal for commands and validating Agent output |
-| **Responsive UI** | Desktop, tablet, and phone layouts that adapt automatically |
-| **Session History** | Resume previous sessions with full context preserved |
-| **Dark/Light Theme** | Customizable appearance and keyboard shortcuts |
+| **Cross-Device Workspace** | Reopen the same coding environment from desktop, tablet, or phone without rebuilding context |
+| **Supervisor Loops** | Run objective-driven evaluation and follow-up cycles for long AI tasks with less manual babysitting |
+| **Claude Code + Codex** | Use both agent CLIs inside one workspace instead of splitting your workflow across separate tools |
+| **Unified Terminal, Editor, and Git** | Keep PTY terminals, Monaco editing, diffs, and changed files in one browser UI |
+| **Responsive Workspace UI** | Use layouts tuned for desktop, tablet, and mobile instead of a desktop-only interface squeezed onto small screens |
+| **Session Continuity** | Resume active sessions and keep AI work visible across device switches |
+| **Local-First Runtime** | Keep code and runtime on your machine instead of relying on a cloud IDE |
 
 ---
 

README.zh-CN.md

@@ -4,63 +4,32 @@
 
 # Coder Studio
 
-</div>
-
-<div align="center">
+**一个浏览器里的 AI 编程工作台，适合在桌面、平板和手机之间切换的开发者。**
 
-**AI 编程工作台 · 浏览器访问 · 跨设备协作 · 本地运行**
+在同一个工作台里运行 Claude Code 和 Codex，让终端、文件、Git 视图和 AI 会话跟着你在不同设备间延续。
 
 [![npm version](https://img.shields.io/npm/v/@spencer-kit/coder-studio.svg)](https://www.npmjs.com/package/@spencer-kit/coder-studio)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D24.0.0-green.svg)](https://nodejs.org/)
 [![GitHub Stars](https://img.shields.io/github/stars/spencerkit/coder-studio?style=social)](https://github.com/spencerkit/coder-studio/stargazers)
-[![GitHub Discussions](https://img.shields.io/github/discussions/spencerkit/coder-studio)](https://github.com/spencerkit/coder-studio/discussions)
-[![Open Issues](https://img.shields.io/github/issues/spencerkit/coder-studio)](https://github.com/spencerkit/coder-studio/issues)
-[![Contributors](https://img.shields.io/github/contributors/spencerkit/coder-studio)](https://github.com/spencerkit/coder-studio/graphs/contributors)
-
-</div>
-
----
-
-> Deploy once, code everywhere.
->
-> 一次部署，随处编码。
-
-[English](README.md) | [文档](docs/help/quick-start.md) | [GitHub](https://github.com/spencerkit/coder-studio)
 
-**Coder Studio** 是一个浏览器端的 AI 编程工作台，运行在你本地的机器上。从任何设备的浏览器访问你的开发环境 —— 在通勤路上用手机查看进度，在平板上审阅代码改动，或在多台电脑之间无缝切换。
+[观看 Demo](docs/assets/demo.mp4) · [快速开始](#快速开始) · [GitHub Star](https://github.com/spencerkit/coder-studio)
 
-## ✨ 核心特性
-
-- 🌐 **浏览器工作台** — 无需桌面应用，任何现代浏览器都能使用
-- 📱 **跨设备连续性** — 在桌面端开始，移动端继续，自由切换设备
-- 🤖 **多 Agent 支持** — 同时运行 Claude Code 和 OpenAI Codex 会话
-- 🔧 **一体化环境** — 终端、文件编辑器、Git 查看器和 AI Agent 统一界面
-- 🔒 **本地运行隐私保护** — 代码保留在你自己的机器上，不依赖云 IDE
-- ⚡ **实时同步** — 所有连接设备的实时工作区状态
-
-![工作区界面](docs/help/assets/screenshot-workspace-overview.png)
-
-[![观看演示视频](docs/assets/demo-poster.png)](docs/assets/demo.mp4)
-
-<div align="center">点击封面查看录制演示视频</div>
+[English](README.md) | [文档](docs/help/quick-start.md)
 
+</div>
 
----
+[![观看演示视频](docs/assets/demo-preview.gif)](docs/assets/demo.mp4)
 
-## 🎯 为什么选择 Coder Studio
+<div align="center">看看同一个编码工作台如何从桌面无缝切到移动端而不丢上下文。</div>
 
-| 特性 | 优势 |
-|------|------|
-| **一次部署，随处继续** | 启动服务一次，在设备间切换不中断工作流 |
-| **统一工作台** | Agent、代码、Git、终端在一处 —— 不再频繁切换应用 |
-| **多 Agent 支持** | 同时运行 Claude Code 和 Codex 会话 |
-| **本地优先 & 隐私** | 运行在你自己的机器上，代码永不离开设备 |
-| **零配置浏览器访问** | 无需桌面客户端，任何设备打开 URL 即可 |
+## 为什么它不一样
 
----
+- **一个浏览器里完成 AI 编程工作流** — 把终端、文件、Git 和 AI 会话放到同一个工作台。
+- **真正为设备切换而设计** — 在桌面端开始，在平板继续，用手机随时查看 Agent 进度。
+- **目标驱动的多轮调度** — 让 Supervisor 接管长任务推进，你不必全程盯守每一轮输出，减少机械重复的人工催促，并获得更稳定的执行效果。
 
-## 🚀 快速开始
+## 快速开始
 
 ```bash
 # 全局安装
@@ -78,23 +47,23 @@ coder-studio open
 
 ## 💡 使用场景
 
-### 远程友好开发
+### 跨设备开发
 
 - 在办公室启动 Agent 任务，通勤路上用手机查看进度
 - 在平板上审阅代码改动，无需打开笔记本电脑
 - 在家用电脑继续工作，零配置切换
 
-### 团队协作
+### 长任务监督与调度
 
-- 与同一网络的队友分享工作区 URL
-- 无需屏幕共享进行代码审阅 —— 直接打开链接
-- 实时向相关人员展示 Agent 进度
+- 让 Supervisor 围绕目标持续推进多轮任务，不必一直盯着终端
+- 用手机查看评估循环和后续动作，而不是守着每轮输出
+- 减少机械重复的人工催促，让长任务执行更稳
 
 ### AI 辅助编程
 
-- 并行运行多个 Claude Code 或 Codex 会话
-- 在移动端远程监控 Agent 进度
-- 终端、编辑器和 Git 视图统一在一个界面
+- 并行运行 Claude Code 和 Codex 会话
+- 终端、编辑器、Git 和 Supervisor 状态统一在一个界面
+- 切换设备后继续当前 AI 工作，不必重新建立上下文
 
 ---
 
@@ -122,13 +91,13 @@ coder-studio open
 
 | 功能 | 描述 |
 |------|------|
-| **多 Agent 会话** | 同时运行 Claude Code 和 Codex 会话 |
-| **集成编辑器** | Monaco 驱动的代码编辑器，支持语法高亮 |
-| **Git 集成** | 在工作区内查看分支、diff 和变更文件 |
-| **Shell 终端** | 完整 PTY 终端，运行命令和验证 Agent 输出 |
-| **响应式 UI** | 桌面端、平板端和手机端布局自动适配 |
-| **会话历史** | 恢复之前的会话，完整上下文保留 |
-| **深色/浅色主题** | 可自定义外观和快捷键 |
+| **跨设备工作区** | 在桌面、平板和手机之间重新打开同一个编码环境，不必重新建立上下文 |
+| **Supervisor 监督循环** | 围绕目标运行评估与续推循环，减少长任务中的人工盯守 |
+| **Claude Code + Codex** | 在同一个工作区里使用两套 Agent CLI，而不是把工作流拆散到多个工具中 |
+| **终端、编辑器和 Git 一体化** | 在同一个浏览器界面里完成 PTY 终端、Monaco 编辑、diff 和变更查看 |
+| **响应式工作区界面** | 提供面向桌面、平板和手机的布局，而不是把桌面界面硬塞进小屏幕 |
+| **会话连续性** | 切换设备后继续当前活跃会话，让 AI 工作保持可见 |
+| **本地优先运行时** | 代码和运行时都留在你的机器上，不依赖云 IDE |
 
 ---