Skip to content

Commit 12da4a9

Browse files
authored
Merge pull request #27 from spencerkit/develop
Merge develop into main
2 parents 1a4fc47 + bdc1623 commit 12da4a9

291 files changed

Lines changed: 30716 additions & 7002 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.changeset/fresh-icons-heal.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
"@spencer-kit/coder-studio": patch
3+
---
4+
5+
Fix the mobile workspace Git tab tests so CI no longer fails on stale legacy class assertions after the shared tab styling migration.

README.md

Lines changed: 138 additions & 98 deletions
Original file line numberDiff line numberDiff line change
@@ -1,119 +1,169 @@
11
# Coder Studio
22

3+
<div align="center">
4+
5+
**AI Coding Workspace · Browser-Based · Cross-Device · Self-Hosted**
6+
7+
[![npm version](https://img.shields.io/npm/v/@spencer-kit/coder-studio.svg)](https://www.npmjs.com/package/@spencer-kit/coder-studio)
8+
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
9+
[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D24.0.0-green.svg)](https://nodejs.org/)
10+
11+
</div>
12+
13+
---
14+
315
> Deploy once, code everywhere.
416
>
517
> Deploy your coding workspace once, then keep working anywhere.
618
7-
[中文说明](README.zh-CN.md)
19+
[中文说明](README.zh-CN.md) | [Documentation](docs/help/quick-start.md) | [GitHub](https://github.com/spencerkit/coder-studio)
820

9-
Coder Studio lets you launch an AI coding workspace on your machine and keep using it from wherever you are. Claude Code or Codex, files, Git, and terminal all stay in one browser-based workspace, so your workflow is no longer pinned to one desk or one device.
21+
**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.
1022

11-
Start a task in the office, check progress on your phone during the commute, review changes from a tablet, and continue on a laptop later. Same workspace, same context, no environment handoff.
23+
## ✨ Key Features
1224

13-
![Workspace](docs/help/assets/screenshot-workspace-overview.png)
25+
- 🌐 **Browser-Based Workspace** — No desktop app needed, works in any modern browser
26+
- 📱 **Cross-Device Continuity** — Start on desktop, continue on mobile, switch devices freely
27+
- 🤖 **Multi-Agent Support** — Run Claude Code and OpenAI Codex sessions side by side
28+
- 🔧 **Integrated Environment** — Terminal, file editor, Git viewer, and AI agents in one interface
29+
- 🔒 **Self-Hosted & Private** — Code stays on your machine, no cloud IDE dependency
30+
-**Real-Time Sync** — Live workspace state across all connected devices
1431

15-
## Why Coder Studio
32+
![Workspace Overview](docs/help/assets/screenshot-workspace-overview.png)
1633

17-
- **Deploy once, continue anywhere**: start the service once and move between devices and contexts without breaking your flow
18-
- **One workspace across devices**: not just remote logs, but the same workspace with Agent, code, Git, and terminal
19-
- **Agent + Code + Git + Terminal in one place**: less context switching between CLI, editor, diff tools, and shell
20-
- **Works with Claude Code and Codex**: choose the right Agent per task and run sessions side by side
21-
- **Runs locally, keeps your data under your control**: the service runs on your machine, without relying on a third-party cloud IDE
34+
---
2235

23-
## What Problem It Solves
36+
## 🎯 Why Coder Studio
2437

25-
Traditional AI coding workflows are often tied to the one machine where the CLI is running:
38+
| Feature | Benefit |
39+
|---------|---------|
40+
| **Deploy once, continue anywhere** | Start the service once, move between devices without breaking flow |
41+
| **Unified workspace** | Agent, code, Git, and terminal in one place — no more app switching |
42+
| **Multi-Agent support** | Run Claude Code and Codex sessions side by side |
43+
| **Local-first & private** | Runs on your machine, code never leaves your device |
44+
| **Zero-config browser access** | No desktop client, just open a URL from any device |
2645

27-
- The Agent is running, but you still have to stay near the original device
28-
- Changing locations makes it hard to keep watching context and execution state
29-
- A phone may show notifications, but not the full coding workspace
30-
- Switching devices usually means taking over the environment again instead of simply continuing the work
46+
---
3147

32-
Coder Studio turns that into:
33-
34-
`Deploy once, code everywhere.`
35-
36-
## Quick Start
48+
## 🚀 Quick Start
3749

3850
```bash
51+
# Install globally
3952
npm install -g @spencer-kit/coder-studio
53+
54+
# Launch the workspace
4055
coder-studio open
4156
```
4257

43-
Then just:
58+
Your browser opens automatically. Select your project folder and start working with Claude Code or OpenAI Codex.
4459

45-
1. Click **Open Workspace** in the browser
46-
2. Choose your project directory and create a Claude or Codex session
47-
3. Start working with the Agent while viewing files, Git changes, and terminal output in the same workspace
60+
> **No AI CLI installed yet?** You can still browse files and use the terminal. Install Claude Code or Codex later when needed.
4861
49-
> You can open the UI and browse files and terminals before installing a provider CLI. See the [Provider Setup Guide](docs/help/providers.md) for details.
62+
---
5063

51-
## How You Can Use It
64+
## 💡 Use Cases
5265

53-
| Scenario | What you do |
54-
|----------|-------------|
55-
| Start work in the office | Launch the service, open the project, create a Claude or Codex session, and let the Agent begin |
56-
| Check progress during a commute | Open the same workspace on your phone and review Agent output, session status, and Git changes |
57-
| Review changes while away from your desk | Use a tablet to browse files, inspect diffs, and confirm terminal output |
58-
| Continue later on another device | Reconnect to the same workspace and keep going with the same context |
59-
| Share progress with teammates | Let others on the same local network open the workspace in a browser and view the current state |
66+
### Remote-Friendly Development
6067

61-
## What You Can Do
68+
- Start an Agent task at the office, check progress on your phone during commute
69+
- Review code changes on a tablet without opening your laptop
70+
- Continue work from a home computer with zero setup
6271

63-
- Run multiple Agent sessions inside one workspace
64-
- Watch the file tree, editor, and Git diff while the Agent is working
65-
- Open a Shell terminal to validate the Agent's output yourself
66-
- Use the full multi-panel desktop layout and keyboard shortcuts
67-
- Monitor workspace and session progress from a phone or tablet
68-
- Manage themes, language, shortcuts, and provider arguments from Settings
72+
### Team Collaboration
6973

70-
## Works Across Devices
74+
- Share workspace URL with teammates on the same network
75+
- Code review without screen sharing — just open the link
76+
- Real-time visibility into Agent progress for stakeholders
7177

72-
Coder Studio runs in a standard browser and does not require a desktop client:
78+
### AI-Assisted Coding
7379

74-
- **Desktop**: best for full coding sessions, editing files, reviewing diffs, and managing panels
75-
- **Tablet**: useful for lightweight review, tracking Agent progress, and browsing project state
76-
- **Phone**: useful for checking session status, terminal output, and workspace changes on the go
80+
- Run multiple Claude Code or Codex sessions in parallel
81+
- Monitor Agent progress from mobile while away from desk
82+
- Keep terminal, editor, and Git view in one unified interface
7783

78-
The same service URL can be opened from different devices, and the interface adapts to the screen automatically.
84+
---
7985

80-
**Desktop Workspace**
86+
## 📱 Cross-Device Experience
87+
88+
| Device | Best For |
89+
|--------|----------|
90+
| 🖥️ **Desktop** | Full coding sessions, file editing, diff review, panel management |
91+
| 📱 **Tablet** | Code review, Agent progress tracking, file browsing |
92+
| 📲 **Phone** | Quick status checks, terminal output monitoring, session viewing |
93+
94+
The same workspace URL works across all devices — interface adapts automatically.
95+
96+
**Desktop Interface**
8197

8298
![Desktop Workspace](docs/help/assets/screenshot-pc.png)
8399

84-
**Mobile Workspace**
100+
**Mobile Interface**
85101

86102
![Mobile Workspace](docs/help/assets/screenshot-mobile.png)
87103

88-
## Core Capabilities
104+
---
105+
106+
## 🛠️ Feature Overview
89107

90-
- **Workspace**: a local project directory with its own files, terminals, Git state, and sessions
91-
- **Session**: an independent Claude or Codex Agent run inside a workspace
92-
- **Terminal**: both Shell terminals and Agent terminals are supported
93-
- **Git View**: inspect branches, changed files, and diffs directly inside the workspace
94-
- **Settings**: manage themes, language, shortcuts, and provider startup arguments in one place
108+
| Feature | Description |
109+
|---------|-------------|
110+
| **Multi-Agent Sessions** | Run Claude Code and Codex sessions side by side |
111+
| **Integrated Editor** | Monaco-powered code editor with syntax highlighting |
112+
| **Git Integration** | View branches, diffs, and changed files without leaving workspace |
113+
| **Shell Terminal** | Full PTY terminal for commands and validating Agent output |
114+
| **Responsive UI** | Desktop, tablet, and phone layouts that adapt automatically |
115+
| **Session History** | Resume previous sessions with full context preserved |
116+
| **Dark/Light Theme** | Customizable appearance and keyboard shortcuts |
95117

96-
## Documentation
118+
---
97119

98-
- [Quick Start](docs/help/quick-start.md) - From install to first launch
99-
- [App Overview](docs/help/app-overview.md) - Core concepts and capabilities
100-
- [Provider Setup](docs/help/providers.md) - Install and configure Claude Code / Codex CLI
101-
- [Desktop Guide](docs/help/desktop-guide.md) - Desktop interface and workflows
102-
- [Mobile Guide](docs/help/mobile-guide.md) - Phone and tablet usage
103-
- [Common Workflows](docs/help/workflows.md) - Task-oriented usage patterns
104-
- [Troubleshooting](docs/help/troubleshooting.md) - Common issues and fixes
105-
- [CLI Reference](docs/help/cli.md) - Command-line reference
120+
## 📋 Requirements
106121

107-
## Installation Requirements
122+
| Dependency | Version | Notes |
123+
|------------|---------|-------|
124+
| Node.js | ≥ 24.0.0 | Required for running Coder Studio |
125+
| Claude Code CLI | Latest | Optional — for Claude Agent sessions |
126+
| OpenAI Codex CLI | Latest | Optional — for Codex Agent sessions |
127+
128+
---
129+
130+
## 📚 Documentation
131+
132+
| Resource | Description |
133+
|----------|-------------|
134+
| [Quick Start Guide](docs/help/quick-start.md) | Installation to first workspace |
135+
| [App Overview](docs/help/app-overview.md) | Core concepts and features |
136+
| [Provider Setup](docs/help/providers.md) | Claude Code / Codex CLI installation |
137+
| [Desktop Guide](docs/help/desktop-guide.md) | PC interface and shortcuts |
138+
| [Mobile Guide](docs/help/mobile-guide.md) | Phone / tablet usage |
139+
| [Common Workflows](docs/help/workflows.md) | Task-based tutorials |
140+
| [Troubleshooting](docs/help/troubleshooting.md) | FAQ and known issues |
141+
| [CLI Reference](docs/help/cli.md) | Command-line options |
108142

109-
| Requirement | Notes |
110-
|-------------|-------|
111-
| Node.js >= 24.0.0 | Required to run the Coder Studio service |
112-
| Claude Code CLI or OpenAI Codex CLI | Required to create Agent sessions; files and terminals can still be used before installing a provider |
143+
---
113144

114-
## Contributor Notes
145+
## 👥 Who Should Use Coder Studio
115146

116-
The following section is for repository contributors. Regular users can start with the quick start and product docs above.
147+
- **AI Coding Power Users** — Daily Claude Code / Codex users who want better session management
148+
- **Multi-Device Developers** — Switch between office, home, and mobile devices frequently
149+
- **Remote-First Teams** — Need to share work progress without screen sharing
150+
- **Privacy-Conscious Developers** — Want code to stay on local machine, not cloud IDE
151+
152+
---
153+
154+
## 🔮 Roadmap
155+
156+
- [ ] Web-based terminal streaming optimization
157+
- [ ] Session replay and history navigation
158+
- [ ] Multi-workspace management
159+
- [ ] Plugin system for custom integrations
160+
- [ ] Cloud sync for workspace preferences
161+
162+
---
163+
164+
## 🤝 Contributing
165+
166+
We welcome contributions! See [Contributing Guide](CONTRIBUTING.md) for details.
117167

118168
### Local Development
119169

@@ -123,40 +173,30 @@ pnpm install
123173
pnpm dev
124174
```
125175

126-
### Common Commands
127-
128-
```bash
129-
pnpm changeset
130-
pnpm acceptance:phase1
131-
pnpm build:cli
132-
pnpm lint
133-
pnpm lint:fix
134-
pnpm format
135-
pnpm check
136-
```
137-
138-
### Release Flow
139-
140-
- Release-worthy PRs add a changeset for `@spencer-kit/coder-studio`
141-
- Ordinary PRs can merge without a changeset
142-
- After release-worthy changes land on `main`, GitHub Actions auto-creates or updates a release PR
143-
- Merging the release PR writes the CLI version bump and changelog
144-
- Publishing is manual through the `Publish CLI` workflow, which publishes to npm, creates the git tag, and opens the GitHub release
145-
146176
### Tech Stack
147177

148-
- Frontend: React + Vite + Jotai
149-
- Backend: Fastify + WebSocket
150-
- Terminal: xterm.js + node-pty
151-
- Editor: Monaco Editor
152-
- Storage: SQLite (`node:sqlite`)
178+
| Layer | Technology |
179+
|-------|------------|
180+
| Frontend | React, Vite, Jotai |
181+
| Backend | Fastify, WebSocket |
182+
| Terminal | xterm.js, node-pty |
183+
| Editor | Monaco Editor |
184+
| Storage | SQLite (node:sqlite) |
153185

154186
### Development Docs
155187

156188
- [PRD](docs/PRD.zh-CN.md)
157189
- [Design Spec](docs/superpowers/specs/2026-04-13-coder-studio-design.md)
158190
- [More Docs](docs/)
159191

160-
## License
192+
---
193+
194+
## 📄 License
195+
196+
MIT License — see [LICENSE](LICENSE) for details.
197+
198+
---
199+
200+
## 🔍 Keywords
161201

162-
MIT
202+
`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`

0 commit comments

Comments
 (0)