kurenai-studio / kurenai

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.

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_initialize
• kurenai_project_current
• kurenai_preview_start
• kurenai_preview_status
• kurenai_preview_stop

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.