Kurenai Studio
DSH-native Cocos vibe coding: chat beside a live Headless Cocos preview, inspect
the runtime scene tree, click a node, and use that selection as precise agent
context.
Status: working MVP. Kurenai directly uses each DSH session's workspace
directory as its Cocos project root.
The historical preview research tree lived in
shinjiyu/headless-cocos
(migrated / read-only). Point KURENAI_HEADLESS_ROOT at a local checkout
or runtime kit; do not treat that remote as the product home.
Product loop
Click a node in the preview
→ Kurenai Inspector resolves node/path/components
→ selection becomes DSH chat context
→ agent edits the Cocos project on disk
→ Headless Cocos compiles and HMR refreshes the iframe
Kurenai intentionally edits source files rather than mutating only the browser
runtime, so changes survive reload and remain reviewable.
Workspace workflow
Kurenai does not maintain an independent project registry.
- New project — create/open an empty DSH Workspace, then choose the
base-ai 2D template or base-ai-3d template from the supplied
headless-cocos checkout.
- Existing project — open the Cocos project directory as a DSH Workspace;
Kurenai detects it from
package.json and starts the preview.
- Continue work — reopen the existing DSH Workspace/session. DSH remains
the source of truth for project paths, recent workspaces and conversations.
Repository surfaces
src/index.ts — DSH host plugin and preview lifecycle tools.src/preview/controller.ts — starts/stops an external Headless Cocos checkout.src/project/ — current-DSH-workspace detection, initialization and local
preview control API.src/client/ — DSH shell overlay that splits chat on the left from the
preview/Inspector workspace on the right.src/inspector-runtime/ — browser runtime for scene tree, selection and
initial 2D UI hit testing.src/shared/protocol.ts — versioned postMessage contract between iframe and
DSH.
Current DSH tools
kurenai_project_initializekurenai_project_currentkurenai_preview_startkurenai_preview_statuskurenai_preview_stopkurenai_publish — headless static publish (platform=web MVP; plugin-extensible)
Headless publish CLI (no Creator):
node $env:KURENAI_HEADLESS_ROOT\spike\publish\cli.mjs --project=<cocos-project> --platform=web
See headless-cocos/spike/publish/README.md.
Development
npm install
npm run check
Install a development build into a DSH profile after building:
dsh plugin --profile <profile> add <absolute-path-to-this-repo>
Configure the generated Cordis row with the Cocos project and a local
headless-cocos checkout:
- id: kurenai
name: "@kurenai-studio/dsh-plugin-kurenai"
config:
port: 7460
controlPort: 7459
Point to the Headless Cocos stack through KURENAI_HEADLESS_ROOT. The project
path is always read from the active DSH session cwd.
The runtime kit and Cocos engine binaries are deliberately not distributed by
this repository. Follow the Headless Cocos runtime-kit instructions and Cocos
licensing requirements.
MVP limitations
- DSH does not expose a native center-split slot. Kurenai mounts through the
additive
shell.overlay slot and temporarily reserves right-side frame
padding while open, preserving the original conversation and composer.
- Selecting a node can copy a structured context block. Direct insertion into
the active DSH composer still needs a supported conversation API adapter.
- Initial canvas picking targets 2D
UITransform bounds. Camera-aware 3D
raycasting and complex multi-camera scenes are not implemented.
License
Kurenai source code is MIT licensed. Cocos Creator engine snapshots, packer
binaries and other vendor assets are not part of this repository and remain
under their respective licenses.
