kurenai-studio/kurenai

Install

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

Add kurenai-studio/kurenai to your DSH config (web profile) to enable.