Skip to content

Commit d2b80ef

Browse files
committed
Merge branch 'develop' into feature/header-system
2 parents 81d4c53 + b5925c9 commit d2b80ef

38 files changed

Lines changed: 5651 additions & 605 deletions

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
# Coder Studio
66

7-
**A browser-based vibe coding workspace for developers who move between desktop, tablet, and phone.**
7+
**Coder Studio, made for vibe coding.**
88

99
Run Claude Code and Codex in one workspace. Keep your terminal, files, Git view, and AI sessions available from any device.
1010

README.zh-CN.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
# Coder Studio
66

7-
**一个浏览器里的 vibe coding 工作台,适合在桌面、平板和手机之间切换的开发者**
7+
**Coder Studio,生来就是 vibe coding。**
88

99
在同一个工作台里运行 Claude Code 和 Codex,让终端、文件、Git 视图和 AI 会话跟着你在不同设备间延续。
1010

Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
# Agentic Workspace Phase 1 Positioning Implementation Plan
2+
3+
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
4+
>
5+
> **Spec:** `docs/superpowers/specs/2026-05-17-agentic-workspace-platform-design.md`
6+
7+
**Goal:** Reposition Coder Studio as an agentic workspace for real development while preserving the current vibe coding slogan.
8+
9+
**Architecture:** Documentation-only phase. Update README and Wiki copy so the product is no longer framed as only a Claude Code and Codex workspace, while still naming current supported providers accurately.
10+
11+
**Tech Stack:** Markdown, GitHub README/Wiki docs.
12+
13+
---
14+
15+
## Scope
16+
17+
Includes:
18+
19+
- README positioning update.
20+
- Chinese README positioning update.
21+
- Wiki positioning updates.
22+
- New Wiki page explaining agentic workspace.
23+
- New Wiki page explaining provider-agnostic roadmap.
24+
- New Wiki page comparing Coder Studio and Warp.
25+
26+
Excludes:
27+
28+
- Code changes.
29+
- Custom provider implementation.
30+
- Provider settings UI changes.
31+
- Clone GitHub onboarding.
32+
- Continue recent workspace onboarding.
33+
- Claude/Codex install diagnosis.
34+
35+
## Files
36+
37+
- Modify: `README.md`
38+
- Modify: `README.zh-CN.md`
39+
- Modify: `docs/wiki/Home.md`
40+
- Modify: `docs/wiki/Why-Coder-Studio.md`
41+
- Modify: `docs/wiki/README.md`
42+
- Create: `docs/wiki/What-is-an-Agentic-Workspace.md`
43+
- Create: `docs/wiki/Agent-Providers.md`
44+
- Create: `docs/wiki/Coder-Studio-vs-Warp.md`
45+
46+
## Tasks
47+
48+
- [ ] Update README hero copy to use:
49+
50+
```text
51+
Coder Studio, made for vibe coding.
52+
53+
An agentic workspace for real development. Run, inspect, and supervise coding agents with terminals, files, Git, sessions, and review in one browser workspace.
54+
```
55+
56+
- [ ] Update Chinese README hero copy to use:
57+
58+
```text
59+
Coder Studio,生来就是 vibe coding。
60+
61+
面向真实开发的 agentic workspace。用一个浏览器工作区运行、检查和监督 coding agent,把终端、文件、Git、会话和代码审查放在一起。
62+
```
63+
64+
- [ ] Replace narrow Claude/Codex-only framing with "Claude Code and Codex today, more coding agents over time" where appropriate.
65+
- [ ] Keep feature bullets concrete: terminal, files, Git, sessions, review, cross-device.
66+
- [ ] Move `local-first` into secondary trust copy such as "Your code and runtime stay on your machine."
67+
- [ ] Create `What-is-an-Agentic-Workspace.md` covering definition, why terminal/editor alone is not enough, and why review matters.
68+
- [ ] Create `Agent-Providers.md` covering built-in providers, future presets, custom command providers, and non-goals.
69+
- [ ] Create `Coder-Studio-vs-Warp.md` with the frame: "Warp is the agentic terminal. Coder Studio is the agentic workspace."
70+
- [ ] Update `docs/wiki/README.md` with the new pages.
71+
72+
## Acceptance Criteria
73+
74+
- README does not make Coder Studio sound limited to only Claude Code and Codex.
75+
- README still accurately says current built-in support is Claude Code and Codex.
76+
- Wiki contains a clear provider-agnostic roadmap.
77+
- `local-first` is present as a supporting trust message, not as the headline.
78+
79+
## Verification
80+
81+
```bash
82+
git diff --check -- README.md README.zh-CN.md docs/wiki
83+
```
84+
85+
Expected: no whitespace errors.
86+
87+
## Suggested Commit
88+
89+
```bash
90+
git add README.md README.zh-CN.md docs/wiki
91+
git commit -m "docs: position coder studio as agentic workspace"
92+
```
93+
Lines changed: 130 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,130 @@
1+
# Agentic Workspace Phase 2 Provider Registry Implementation Plan
2+
3+
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
4+
>
5+
> **Spec:** `docs/superpowers/specs/2026-05-17-agentic-workspace-platform-design.md`
6+
7+
**Goal:** Productize the existing provider registry so Coder Studio can present itself as an agent-agnostic platform without replacing the current Claude Code and Codex implementation.
8+
9+
**Architecture:** Extend the existing `ProviderDefinition` shape with platform-facing metadata and capabilities. Add a provider listing command that exposes safe provider metadata to the web app without leaking executable internals.
10+
11+
**Tech Stack:** TypeScript, Zod, Vitest, existing websocket command dispatch.
12+
13+
---
14+
15+
## Scope
16+
17+
Includes:
18+
19+
- Capability metadata on `ProviderDefinition`.
20+
- Safe DTO for frontend provider listing.
21+
- `provider.list` server command.
22+
- Tests for Claude/Codex provider metadata.
23+
- Frontend hook to consume provider list.
24+
25+
Excludes:
26+
27+
- Custom provider persistence.
28+
- New provider presets.
29+
- Install diagnosis redesign.
30+
- Provider marketplace.
31+
32+
## Files
33+
34+
- Modify: `packages/core/src/provider/definition.ts`
35+
- Modify: `packages/core/src/domain/types.ts`
36+
- Modify: `packages/providers/src/claude/definition.ts`
37+
- Modify: `packages/providers/src/codex/definition.ts`
38+
- Modify: `packages/providers/src/registry.ts`
39+
- Modify: `packages/providers/src/registry.test.ts`
40+
- Modify: `packages/server/src/commands/provider.ts`
41+
- Create: `packages/server/src/__tests__/provider-list.test.ts`
42+
- Create: `packages/web/src/features/agent-providers/actions/use-agent-providers.ts`
43+
- Create: `packages/web/src/features/agent-providers/actions/use-agent-providers.test.tsx`
44+
45+
## Data Model
46+
47+
Add:
48+
49+
```ts
50+
export type ProviderKind = "built_in" | "preset" | "custom";
51+
52+
export type ProviderCapabilityKey =
53+
| "interactive_session"
54+
| "supervisor_eval"
55+
| "idle_detection"
56+
| "context_attach"
57+
| "review";
58+
59+
export interface ProviderCapabilityDescriptor {
60+
key: ProviderCapabilityKey;
61+
supported: boolean;
62+
label: string;
63+
}
64+
65+
export interface ProviderListItem {
66+
id: string;
67+
displayName: string;
68+
badge: string;
69+
kind: ProviderKind;
70+
capability: "full" | "limited" | "unsupported";
71+
capabilities: ProviderCapabilityDescriptor[];
72+
requiredCommands: string[];
73+
}
74+
```
75+
76+
Extend `ProviderDefinition` with:
77+
78+
```ts
79+
kind: ProviderKind;
80+
capabilities: ProviderCapabilityDescriptor[];
81+
```
82+
83+
## Tasks
84+
85+
- [ ] Add provider platform types to `packages/core/src/provider/definition.ts` or `packages/core/src/domain/types.ts`.
86+
- [ ] Set `kind: "built_in"` for Claude Code and Codex definitions.
87+
- [ ] Add explicit capabilities for Claude Code and Codex:
88+
89+
```ts
90+
[
91+
{ key: "interactive_session", supported: true, label: "Interactive session" },
92+
{ key: "supervisor_eval", supported: true, label: "Supervisor evaluation" },
93+
{ key: "idle_detection", supported: true, label: "Idle detection" },
94+
{ key: "context_attach", supported: false, label: "Context attach" },
95+
{ key: "review", supported: false, label: "Review" },
96+
]
97+
```
98+
99+
- [ ] Add `toProviderListItem(provider)` helper in `packages/providers/src/registry.ts`.
100+
- [ ] Add tests proving Claude and Codex return safe DTOs.
101+
- [ ] Register `provider.list` in `packages/server/src/commands/provider.ts`.
102+
- [ ] Add server command test asserting `provider.list` returns built-in provider DTOs.
103+
- [ ] Create frontend hook `useAgentProviders()` that calls `provider.list`.
104+
- [ ] Add hook test with mocked websocket dispatch.
105+
106+
## Acceptance Criteria
107+
108+
- The frontend has a provider-agnostic list API.
109+
- Provider executable construction remains server-only.
110+
- Claude Code and Codex appear as built-in providers.
111+
- No custom provider functionality is introduced yet.
112+
113+
## Verification
114+
115+
```bash
116+
pnpm exec vitest run \
117+
packages/providers/src/registry.test.ts \
118+
packages/server/src/__tests__/provider-list.test.ts \
119+
packages/web/src/features/agent-providers/actions/use-agent-providers.test.tsx
120+
```
121+
122+
Expected: all tests pass.
123+
124+
## Suggested Commit
125+
126+
```bash
127+
git add packages/core packages/providers packages/server packages/web/src/features/agent-providers
128+
git commit -m "feat: expose agent provider registry"
129+
```
130+
Lines changed: 127 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,127 @@
1+
# Agentic Workspace Phase 3 Workspace Intelligence Implementation Plan
2+
3+
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
4+
>
5+
> **Spec:** `docs/superpowers/specs/2026-05-17-agentic-workspace-platform-design.md`
6+
7+
**Goal:** Add a project understanding layer that summarizes Git, package manager, framework, commands, docs, and agent instruction state for the active workspace.
8+
9+
**Architecture:** Server-side workspace inspection produces a typed `WorkspaceIntelligenceSummary`. Web UI consumes it through a command and renders a compact setup/context panel inside the workspace.
10+
11+
**Tech Stack:** TypeScript, Node filesystem APIs, Zod, Vitest, React Testing Library.
12+
13+
---
14+
15+
## Scope
16+
17+
Includes:
18+
19+
- Workspace inspection module.
20+
- `workspace.intelligence` command.
21+
- Summary panel in the workspace UI.
22+
- Detection for Git, package managers, package scripts, common frameworks, README/docs, and `AGENTS.md`.
23+
24+
Excludes:
25+
26+
- Code indexing.
27+
- Clone GitHub repo.
28+
- Continue recent workspace flow.
29+
- Provider install diagnosis.
30+
- Automatic command execution.
31+
32+
## Files
33+
34+
- Modify: `packages/core/src/domain/types.ts`
35+
- Create: `packages/server/src/workspace/intelligence.ts`
36+
- Create: `packages/server/src/__tests__/workspace/intelligence.test.ts`
37+
- Modify: `packages/server/src/commands/workspace.ts`
38+
- Create: `packages/server/src/__tests__/workspace-intelligence-command.test.ts`
39+
- Create: `packages/web/src/features/workspace-intelligence/actions/use-workspace-intelligence.ts`
40+
- Create: `packages/web/src/features/workspace-intelligence/components/workspace-intelligence-panel.tsx`
41+
- Create: `packages/web/src/features/workspace-intelligence/components/workspace-intelligence-panel.test.tsx`
42+
- Modify: `packages/web/src/features/workspace/views/desktop/workspace-desktop-view.tsx`
43+
44+
## Data Model
45+
46+
Add:
47+
48+
```ts
49+
export interface WorkspaceIntelligenceSummary {
50+
workspaceId: string;
51+
rootPath: string;
52+
git: {
53+
isRepo: boolean;
54+
branch?: string;
55+
};
56+
packageManager?: "npm" | "pnpm" | "yarn" | "bun";
57+
frameworks: string[];
58+
scripts: {
59+
dev?: string;
60+
test?: string;
61+
build?: string;
62+
lint?: string;
63+
};
64+
recommendedCommands: Array<{
65+
key: "dev" | "test" | "build" | "lint";
66+
command: string;
67+
source: "package_json" | "makefile" | "detected";
68+
}>;
69+
docs: Array<{
70+
path: string;
71+
kind: "readme" | "docs";
72+
}>;
73+
agentInstructions: {
74+
exists: boolean;
75+
path: "AGENTS.md";
76+
};
77+
}
78+
```
79+
80+
## Tasks
81+
82+
- [ ] Implement package manager detection by lockfile priority: `pnpm-lock.yaml`, `yarn.lock`, `bun.lockb`, `package-lock.json`, then `package.json`.
83+
- [ ] Implement package script extraction from `package.json`.
84+
- [ ] Map common script names to recommended commands:
85+
- `dev`
86+
- `test`
87+
- `build`
88+
- `lint`
89+
- [ ] Detect frameworks from dependencies and config files:
90+
- React
91+
- Vite
92+
- Next.js
93+
- Node
94+
- monorepo via `pnpm-workspace.yaml`, `turbo.json`, or `nx.json`
95+
- [ ] Detect Git repository by checking `.git` file or directory.
96+
- [ ] Detect docs via `README.md` and top-level `docs/`.
97+
- [ ] Detect `AGENTS.md`.
98+
- [ ] Register `workspace.intelligence`.
99+
- [ ] Add a desktop panel showing project type, commands, Git state, docs, and instruction state.
100+
- [ ] Keep the panel action-oriented: show recommended commands and `AGENTS.md` state instead of a passive dashboard.
101+
102+
## Acceptance Criteria
103+
104+
- Opening a workspace can produce a stable typed summary.
105+
- Summary works for non-Git folders.
106+
- Summary works when `package.json` is missing.
107+
- UI makes clear whether `AGENTS.md` exists.
108+
- No provider-specific assumptions are required.
109+
110+
## Verification
111+
112+
```bash
113+
pnpm exec vitest run \
114+
packages/server/src/__tests__/workspace/intelligence.test.ts \
115+
packages/server/src/__tests__/workspace-intelligence-command.test.ts \
116+
packages/web/src/features/workspace-intelligence/components/workspace-intelligence-panel.test.tsx
117+
```
118+
119+
Expected: all tests pass.
120+
121+
## Suggested Commit
122+
123+
```bash
124+
git add packages/core packages/server packages/web/src/features/workspace-intelligence packages/web/src/features/workspace/views/desktop/workspace-desktop-view.tsx
125+
git commit -m "feat: add workspace intelligence summary"
126+
```
127+

0 commit comments

Comments
 (0)