Skip to content

Merge develop into main for minor release #72

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pallyoung merged 10 commits into from
Jun 7, 2026
Merged

Merge develop into main for minor release #72

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
f8d2095
feat: expand provider runtime support
pallyoung Jun 7, 2026
6ee0e28
feat: add agent instructions and skills management
pallyoung Jun 7, 2026
ab91d24
feat: add work analysis dashboard
pallyoung Jun 7, 2026
85275c5
feat: harden workspace runtime operations
pallyoung Jun 7, 2026
a42f1bb
feat: refine workspace editor and terminal UX
pallyoung Jun 7, 2026
5ca520a
feat: improve diagnostics and settings surfaces
pallyoung Jun 7, 2026
da9cba1
docs: refresh product specs and project docs
pallyoung Jun 7, 2026
93e05d6
chore: add minor release changeset
pallyoung Jun 7, 2026
6ad96fd
fix: close work analysis database on shutdown
pallyoung Jun 7, 2026
8a4d96a
test: wait for diagnostics install output subscription
pallyoung Jun 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
5 changes: 5 additions & 0 deletions .changeset/agent-workspace-minor.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@spencer-kit/coder-studio": minor
---

Add expanded provider runtime support, agent instruction generation, skills management, and work analysis dashboard updates.
8 changes: 7 additions & 1 deletion .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ build/
output/
.cache/
.turbo/
.vite-style-build-*/

# Test outputs
coverage/
Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -72,4 +79,3 @@ tsconfig.tsbuildinfo
# Rust build artefacts (from lsp-test/ fixture or any ad-hoc cargo)
target/
Cargo.lock

79 changes: 39 additions & 40 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand All @@ -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

Expand All @@ -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.

---

Expand All @@ -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
Expand All @@ -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 |

---

Expand All @@ -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 |

---

Expand All @@ -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 |
Expand All @@ -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

---

Expand All @@ -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
Expand Down Expand Up @@ -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`
Loading
Loading