spencerkit · pallyoung · Jun 15, 2026 · Jun 14, 2026 · Jun 14, 2026 · Jun 14, 2026
diff --git a/.changeset/fair-bears-tell.md b/.changeset/fair-bears-tell.md
@@ -0,0 +1,5 @@
+---
+"@spencer-kit/coder-studio": patch
+---
+
+Stabilize the web test suite and fix workspace UI and dev-browser regressions.
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,11 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Quick Start
+    url: https://github.com/spencerkit/coder-studio/blob/main/docs/wiki/Quick-Start.md
+    about: Install and launch Coder Studio.
+  - name: First Agent Run
+    url: https://github.com/spencerkit/coder-studio/blob/main/docs/wiki/First-Agent-Run.md
+    about: Run Claude or Codex and review your first diff.
+  - name: Security and Privacy
+    url: https://github.com/spencerkit/coder-studio/blob/main/docs/wiki/Security-and-Privacy.md
+    about: Understand local-first behavior and remote access risks.
diff --git a/.github/ISSUE_TEMPLATE/feature-request.yml b/.github/ISSUE_TEMPLATE/feature-request.yml
@@ -0,0 +1,43 @@
+name: Feature request
+description: Suggest a product improvement or missing workflow.
+title: "Feature: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: workflow
+    attributes:
+      label: Workflow problem
+      description: What were you trying to do?
+    validations:
+      required: true
+  - type: textarea
+    id: current
+    attributes:
+      label: Current behavior
+      description: What makes the workflow hard today?
+    validations:
+      required: true
+  - type: textarea
+    id: desired
+    attributes:
+      label: Desired behavior
+      description: Describe the smallest useful version of the improvement.
+    validations:
+      required: true
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - First run / onboarding
+        - Agent sessions
+        - Git review
+        - Terminal
+        - Mobile / remote access
+        - Supervisor
+        - Work Analysis
+        - Skills
+        - Provider integrations
+        - Other
+    validations:
+      required: true
diff --git a/.github/ISSUE_TEMPLATE/installation.yml b/.github/ISSUE_TEMPLATE/installation.yml
@@ -0,0 +1,60 @@
+name: Installation issue
+description: Report problems installing, launching, or opening Coder Studio.
+title: "Installation: "
+labels: ["installation"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a first-run issue. Please remove secrets, private paths, API keys, and sensitive logs.
+  - type: textarea
+    id: steps
+    attributes:
+      label: What did you try?
+      description: Include the exact commands you ran.
+      placeholder: |
+        npm install -g @spencer-kit/coder-studio
+        coder-studio open
+    validations:
+      required: true
+  - type: textarea
+    id: result
+    attributes:
+      label: What happened?
+      description: Paste the visible error or describe the behavior.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: What did you expect?
+    validations:
+      required: true
+  - type: input
+    id: node
+    attributes:
+      label: Node.js version
+      placeholder: "node --version"
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Coder Studio version
+      placeholder: "coder-studio version"
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+      placeholder: "macOS 15, Ubuntu 24.04, Windows 11"
+    validations:
+      required: true
+  - type: textarea
+    id: status
+    attributes:
+      label: Service status and logs
+      description: Include `coder-studio status` and relevant `coder-studio logs` output. Remove secrets.
+    validations:
+      required: false
diff --git a/.github/ISSUE_TEMPLATE/provider-setup.yml b/.github/ISSUE_TEMPLATE/provider-setup.yml
@@ -0,0 +1,54 @@
+name: Provider setup issue
+description: Report Claude, Codex, or other Provider CLI detection problems.
+title: "Provider setup: "
+labels: ["provider"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this when Coder Studio cannot find or start a Provider CLI. Remove secrets and private project details.
+  - type: dropdown
+    id: provider
+    attributes:
+      label: Provider
+      options:
+        - Claude Code
+        - Codex
+        - Gemini CLI
+        - Cursor Agent
+        - OpenCode
+        - Aider-style CLI
+    validations:
+      required: true
+  - type: textarea
+    id: commands
+    attributes:
+      label: Verification commands
+      description: Paste relevant output from `which`, `--version`, and Coder Studio logs.
+      placeholder: |
+        which claude
+        claude --version
+        coder-studio logs
+    validations:
+      required: true
+  - type: textarea
+    id: app
+    attributes:
+      label: What does Coder Studio show?
+      description: Describe the UI state or error message.
+    validations:
+      required: true
+  - type: input
+    id: shell
+    attributes:
+      label: Shell and terminal
+      placeholder: "zsh, bash, PowerShell, Windows Terminal"
+    validations:
+      required: false
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+      placeholder: "macOS 15, Ubuntu 24.04, Windows 11"
+    validations:
+      required: true
diff --git a/.github/ISSUE_TEMPLATE/workflow-showcase.yml b/.github/ISSUE_TEMPLATE/workflow-showcase.yml
@@ -0,0 +1,31 @@
+name: Show your workflow
+description: Share how you use Coder Studio and what should improve.
+title: "Workflow: "
+labels: ["workflow"]
+body:
+  - type: textarea
+    id: setup
+    attributes:
+      label: Your setup
+      description: Which agent, OS, device mix, and repository type are you using?
+    validations:
+      required: true
+  - type: textarea
+    id: workflow
+    attributes:
+      label: Workflow
+      description: Describe the task from start to finish.
+    validations:
+      required: true
+  - type: textarea
+    id: useful
+    attributes:
+      label: What worked well?
+    validations:
+      required: false
+  - type: textarea
+    id: friction
+    attributes:
+      label: What was confusing or slow?
+    validations:
+      required: false
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -0,0 +1,69 @@
+# Contributing
+
+Thanks for helping improve Coder Studio.
+
+Coder Studio is a self-hosted browser workspace for AI coding agent workflows. The most useful early feedback is concrete: what you tried, what happened, what you expected, and where the first-run path became unclear.
+
+## Good First Feedback
+
+Please open an issue when you hit:
+
+- installation problems
+- Provider CLI detection problems
+- first agent session confusion
+- mobile or remote access setup issues
+- documentation that does not match the current UI
+- a workflow that feels promising but needs one missing capability
+
+## Before Filing An Issue
+
+Run these commands when relevant:
+
+```bash
+node --version
+coder-studio version
+coder-studio status
+coder-studio logs
+which claude
+which codex
+claude --version
+codex --version
+```
+
+Do not paste secrets, API keys, private source code, or full logs that contain sensitive data.
+
+## Development Setup
+
+```bash
+git clone https://github.com/spencerkit/coder-studio.git
+cd coder-studio
+pnpm install
+pnpm dev
+```
+
+## Verification
+
+Before handing off code changes, run the relevant command:
+
+```bash
+pnpm ci:verify
+```
+
+For docs-only changes, at least run:
+
+```bash
+git diff --check
+pnpm ci:lint
+```
+
+## Pull Request Expectations
+
+- Keep changes focused.
+- Do not bundle unrelated refactors.
+- Include screenshots or short recordings for UI changes.
+- Update docs when behavior changes.
+- Mention what verification you ran.
+
+## Security
+
+Do not report sensitive security issues in public issues if they include exploitable details. Open a minimal public issue asking for a private contact path, or contact the maintainer through the repository owner profile.
diff --git a/README.md b/README.md
@@ -4,11 +4,11 @@
 
 # Coder Studio
 
-**The all-in-one vibe coding workspace for AI agents.**
+**Self-hosted browser workspace for AI coding agents.**
 
-Coder Studio brings your code editor, Git, terminals, AI coding agents, session review, notifications, work analysis, and Skills into one browser workspace.
+Coder Studio brings Claude Code, Codex, terminals, files, Git diff review, Supervisor loops, Work Analysis, and Skills into one browser workspace you run on your own machine.
 
-It helps keep agent context, progress, and follow-up work visible across desktop, tablet, and phone, so vibe coding feels less scattered and more controllable.
+Use it when raw terminal-only AI coding starts to feel scattered: start an agent task on desktop, review the changed files and diff beside the session, monitor long-running work, and reopen the same workspace from a tablet or phone.
 
 Works with popular coding agents including Claude Code, Codex, Gemini CLI, Cursor Agent, OpenCode, and Aider-style CLI agents.
 
@@ -17,16 +17,27 @@ Works with popular coding agents including Claude Code, Codex, Gemini CLI, Curso
 [![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)
 
-[View Workspace](docs/help/assets/screenshot-desktop-workspace-full.png) · [Quick Start](#quick-start) · [Star on GitHub](https://github.com/spencerkit/coder-studio)
+[Watch Demo](docs/assets/demo.mp4) · [Quick Start](#quick-start) · [English Docs](docs/wiki/Quick-Start.md) · [Star on GitHub](https://github.com/spencerkit/coder-studio)
 
-[中文说明](README.zh-CN.md) | [Documentation](docs/help/quick-start.md)
+[中文说明](README.zh-CN.md) | [Security & Privacy](docs/wiki/Security-and-Privacy.md) | [Known Limitations](docs/wiki/Known-Limitations.md)
 
 </div>
 
 [![Workspace Preview](docs/help/assets/screenshot-desktop-workspace-full.png)](docs/help/assets/screenshot-desktop-workspace-full.png)
 
 <div align="center">Preview the full workspace layout built for agent runs, review, supervision, and device switching.</div>
 
+## What You Can Try In 5 Minutes
+
+1. Install with `npm install -g @spencer-kit/coder-studio`.
+2. Launch with `coder-studio open`.
+3. Open one local repository.
+4. Start an agent session. For a first trial, Claude or Codex is the recommended path.
+5. Ask the agent for a small change, then review the Git diff beside the session.
+6. Reopen the same workspace from a tablet or phone to check progress.
+
+Coder Studio is not a cloud IDE, not a VS Code replacement, and not an AI model provider. It is a self-hosted workbench around the AI coding agents and local tools you already use.
+
 ## Why Coder Studio?
 
 Vibe coding feels fast until the agent output turns into real project work: you still need to run agents, inspect edits, manage Git, monitor long tasks, and improve the next run. Coder Studio keeps that loop in one programming workbench.
@@ -136,17 +147,14 @@ The same workspace URL works across all devices — interface adapts automatical
 
 | Resource | Description |
 |----------|-------------|
-| [Quick Start Guide](docs/help/quick-start.md) | Installation to first workspace |
-| [App Overview](docs/help/app-overview.md) | Core concepts and features |
-| [Agent CLI Setup](docs/help/providers.md) | Install and connect coding agent CLIs |
-| [Desktop Guide](docs/help/desktop-guide.md) | PC interface and shortcuts |
-| [Mobile & Remote Access Guide](docs/help/mobile-guide.md) | Phone / tablet usage, LAN access, Tailscale/ngrok/Cloudflare Tunnel |
-| [Work Analysis](docs/help/work-analysis.md) | Review workspace activity, agent sessions, and improvement opportunities |
-| [Common Workflows](docs/help/workflows.md) | Task-based tutorials |
-| [Troubleshooting](docs/help/troubleshooting.md) | FAQ and known issues |
-| [CLI Reference](docs/help/cli.md) | Command-line options |
-| [GitHub Wiki Source](docs/wiki/README.md) | Wiki source pages and publish flow |
-| [AI Coding Terms](docs/wiki/AI-Coding-Terms.md) | Vibe coding, agentic harnesses, eval harnesses, and where Coder Studio fits |
+| [Quick Start](docs/wiki/Quick-Start.md) | Install, launch, and open your first workspace |
+| [First Agent Run](docs/wiki/First-Agent-Run.md) | Run a recommended first provider, inspect output, and review Git diff |
+| [Agent Providers](docs/wiki/Agent-Providers.md) | Install and verify coding agent CLIs |
+| [Mobile and Remote Access](docs/wiki/Mobile-and-Remote-Access.md) | LAN, Tailscale, ngrok, Cloudflare Tunnel, and phone/tablet usage |
+| [Security and Privacy](docs/wiki/Security-and-Privacy.md) | Local-first model, provider boundaries, and remote access risks |
+| [Known Limitations](docs/wiki/Known-Limitations.md) | Current requirements and product boundaries |
+| [Troubleshooting](docs/wiki/Troubleshooting.md) | First-run problems, Provider CLI issues, and service recovery |
+| [Chinese Help Center](docs/help/README.md) | 中文帮助中心 |
 
 ---
 
@@ -164,7 +172,6 @@ The same workspace URL works across all devices — interface adapts automatical
 - [ ] Web-based terminal streaming optimization
 - [ ] Session replay and history navigation
 - [ ] Multi-workspace management
-- [ ] Plugin system for custom integrations
 - [ ] Workspace preference sync
 
 ---