Merge pull request #72 from spencerkit/develop

Merge develop into main for minor release

Author: pallyoung

.changeset/agent-workspace-minor.md

@@ -0,0 +1,5 @@
+---
+"@spencer-kit/coder-studio": minor
+---
+
+Add expanded provider runtime support, agent instruction generation, skills management, and work analysis dashboard updates.

.gitignore

@@ -7,6 +7,7 @@ build/
 output/
 .cache/
 .turbo/
+.vite-style-build-*/
 
 # Test outputs
 coverage/
@@ -39,6 +40,12 @@ temp/
 .worktrees/
 .claude/
 
+# Local agent instruction overrides
+/AGENTS.md
+/AGENTS.override.md
+/CLAUDE.local.md
+/GEMINI.md
+
 # Acceptance runtime artifacts
 docs/验收报告/**/*.json
 
@@ -72,4 +79,3 @@ tsconfig.tsbuildinfo
 # Rust build artefacts (from lsp-test/ fixture or any ad-hoc cargo)
 target/
 Cargo.lock
-

README.md

@@ -4,11 +4,13 @@
 
 # Coder Studio
 
-**Coder Studio, made for vibe coding.**
+**The all-in-one vibe coding workspace for AI agents.**
 
-An agentic workspace for real development. Run, inspect, and supervise coding agents with terminals, files, Git, sessions, and review in one browser workspace.
+Coder Studio brings your code editor, Git, terminals, AI coding agents, session review, notifications, work analysis, and Skills into one browser workspace.
 
-Built-in support today: Claude Code and Codex. Your code and runtime stay on your 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.
+
+Works with popular coding agents including Claude Code, Codex, Gemini CLI, Cursor Agent, OpenCode, and Aider-style CLI agents.
 
 [![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)
@@ -25,31 +27,20 @@ Built-in support today: Claude Code and Codex. Your code and runtime stay on you
 
 <div align="center">Preview the full workspace layout built for agent runs, review, supervision, and device switching.</div>
 
-## Why It Feels Different
-
-- **One browser workspace for real agent work** — Keep terminals, files, Git, sessions, and review in one place.
-- **Built for device switching** — Start on desktop, continue on tablet, and check progress from your phone.
-- **Keep control local** — Your code and runtime stay on your machine.
-
 ## Why Coder Studio?
 
-Vibe coding agents are fast, but real development still gets fragmented:
-
-- the agent runs in one terminal
-- files and diffs live in another editor
-- verification happens in separate shell tabs
-- long-running tasks are hard to monitor away from your desk
-- mobile access usually means SSH or remote desktop
+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.
 
-Coder Studio turns that scattered workflow into one local browser workspace.
-
-| Pain | Without Coder Studio | With Coder Studio |
-|------|----------------------|-------------------|
-| Long agent tasks | Watch a terminal or come back later and reconstruct context | Keep sessions, terminal output, files, and Git changes visible in one workspace |
-| Cross-device work | Use SSH, remote desktop, or rebuild context on another machine | Reopen the same local workspace from desktop, tablet, or phone |
-| Reviewing AI changes | Jump between terminal, editor, and Git tools | Inspect files and diffs beside the agent session |
-| Multiple agents | Manage separate terminal windows and histories | Run built-in Claude Code and Codex sessions side by side in one workspace today |
-| Local-first control | Move work into a hosted IDE or cloud VM | Keep the runtime and project files on your own machine |
+| Feature | Pain It Solves | What Coder Studio Provides |
+|---------|----------------|----------------------------|
+| **Agent Sessions** | Prompts, terminals, and histories scatter across tools. | Launch Claude Code, Codex, Gemini CLI, Cursor Agent, OpenCode, and CLI-style agents from one workspace. |
+| **Editor, Terminal, and Git** | Understanding one task means jumping between editor, shell tabs, Git tools, and diff viewers. | Keep code editing, terminal output, Git status, changed files, and diffs together. |
+| **Reviewable AI Changes** | The agent says it is done, but you still need to know what is safe to keep. | Inspect changed files and diffs beside the agent session before adjusting, rejecting, or accepting edits. |
+| **Supervisor Loops** | Long tasks stall, drift, or require repeated manual follow-up. | Evaluate progress and continue follow-up steps around the objective. |
+| **Status and Notifications** | You keep checking terminal output just to know whether work finished or needs attention. | Surface session state changes and completion notices in the workspace. |
+| **Cross-Device Workspace** | SSH, remote desktop, or another machine breaks the task context. | Reopen the same workspace from desktop, tablet, or phone to check progress and review changes. |
+| **Work Analysis** | Logs and diffs do not make it easy to understand what happened over time. | Review activity, agent usage, bottlenecks, repeated patterns, and skill candidates. |
+| **Skills Management** | The same instructions and workflows get repeated across agent runs. | Install and mount reusable Skills so agents start with stronger context and need fewer reminders. |
 
 ## Quick Start
 
@@ -61,9 +52,9 @@ npm install -g @spencer-kit/coder-studio
 coder-studio open
 ```
 
-Your browser opens automatically. Select your project folder and start working with Claude Code or OpenAI Codex today.
+Your browser opens automatically. Select your project folder and start an AI coding agent session.
 
-> **No AI CLI installed yet?** You can still browse files and use the terminal. Install Claude Code or Codex later when needed.
+> **No AI coding agent CLI installed yet?** You can still browse files and use the terminal. Install your preferred agent CLI later when needed.
 
 ---
 
@@ -73,20 +64,26 @@ Your browser opens automatically. Select your project folder and start working w
 
 - 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
+- Reopen the same workspace from another device without rebuilding session context
 
 ### Long-Running AI Workflows
 
 - 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
+- Use completion notices and status updates to know when agent work needs attention
 
 ### AI-Assisted Coding
 
-- Run Claude Code and Codex sessions side by side today
+- Run Claude Code, Codex, Gemini CLI, Cursor Agent, OpenCode, or Aider-style CLI agent sessions
 - Keep terminal, editor, Git, and supervisor state in one unified interface
 - Resume active AI work from another device without rebuilding context
 
+### Work Review and Skills
+
+- Use Work Analysis to review agent sessions, activity patterns, bottlenecks, and follow-up ideas
+- Manage Skills from the workspace so agents can reuse the right workflow knowledge
+- Turn repeated review findings into better future agent runs
+
 ---
 
 ## 📱 Cross-Device Experience
@@ -113,14 +110,16 @@ The same workspace URL works across all devices — interface adapts automatical
 
 | Feature | Description |
 |---------|-------------|
+| **One-Stop Programming Workbench** | Combine code editing, PTY terminals, Git status, diffs, agent sessions, and review in one browser UI |
 | **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 |
-| **Built-in Agent Providers** | Use Claude Code and Codex inside one workspace today instead of splitting your workflow across separate tools |
-| **Unified Terminal, Files, and Git** | Keep PTY terminals, Monaco editing, diffs, and changed files in one browser UI |
+| **Popular Coding Agents** | Run Claude Code, Codex, Gemini CLI, Cursor Agent, OpenCode, and CLI-style agents from one workspace |
+| **Notifications and Status Updates** | Surface errors, state changes, and session completion notices without leaving the workspace |
+| **Work Analysis** | Recap workspace activity, agent sessions, patterns, bottlenecks, and possible skill opportunities |
+| **Skills Management** | Search, install, mount, repair, and review Skills that help agents follow reusable workflows |
 | **Reviewable AI Work** | Inspect changed files and diffs beside the session before trusting the result |
 | **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 Runtime Control** | Keep code and runtime on your machine instead of relying on a cloud IDE |
 
 ---
 
@@ -129,8 +128,7 @@ The same workspace URL works across all devices — interface adapts automatical
 | Dependency | Version | Notes |
 |------------|---------|-------|
 | Node.js | ≥ 24.0.0 | Required for running Coder Studio |
-| Claude Code CLI | Latest | Optional — for Claude Agent sessions |
-| OpenAI Codex CLI | Latest | Optional — for Codex Agent sessions |
+| AI coding agent CLI | Latest | Optional — install the CLI for each agent you want to run |
 
 ---
 
@@ -140,9 +138,10 @@ The same workspace URL works across all devices — interface adapts automatical
 |----------|-------------|
 | [Quick Start Guide](docs/help/quick-start.md) | Installation to first workspace |
 | [App Overview](docs/help/app-overview.md) | Core concepts and features |
-| [Provider Setup](docs/help/providers.md) | Claude Code / Codex CLI installation |
+| [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 |
@@ -154,9 +153,9 @@ The same workspace URL works across all devices — interface adapts automatical
 ## 👥 Who Should Use Coder Studio
 
 - **Developers Running Coding Agents** — Want terminals, files, Git, sessions, and review in one place
+- **Vibe Coding Users** — Want an agentic workspace instead of scattered terminal-only workflows
 - **Multi-Device Developers** — Switch between office, home, and mobile devices frequently
 - **Developers Running Long AI Tasks** — Want Supervisor to keep multi-step work moving without constant babysitting
-- **Privacy-Conscious Developers** — Want code to stay on local machine, not cloud IDE
 
 ---
 
@@ -166,15 +165,15 @@ The same workspace URL works across all devices — interface adapts automatical
 - [ ] Session replay and history navigation
 - [ ] Multi-workspace management
 - [ ] Plugin system for custom integrations
-- [ ] Cloud sync for workspace preferences
+- [ ] Workspace preference sync
 
 ---
 
 ## 🤝 Contributing
 
 We welcome contributions! See [Contributing Guide](CONTRIBUTING.md) for details.
 
-### Local Development
+### Development Setup
 
 ```bash
 git clone https://github.com/spencerkit/coder-studio.git
@@ -208,4 +207,4 @@ MIT License — see [LICENSE](LICENSE) for details.
 
 ## 🔍 Keywords
 
-`ai coding assistant` `browser ide` `claude code` `codex` `remote development` `web-based ide` `self-hosted ide` `cross-device coding` `ai agent workspace` `local-first development` `mobile coding` `tablet coding` `developer tools` `terminal in browser` `git web interface` `monaco editor` `websocket terminal` `ai pair programming` `coding anywhere` `cloud ide alternative`
+`vibe coding` `agentic coding` `ai coding agent` `coding agent workspace` `browser ide` `claude code` `codex` `gemini cli` `cursor agent` `opencode` `aider` `cross-device coding` `ai agent workspace` `mobile coding` `tablet coding` `developer tools` `terminal in browser` `git web interface` `monaco editor` `websocket terminal` `ai pair programming` `supervisor loops`