DeepSeek Harness plugin

kurenai

DSH-native Cocos vibe coding studio with headless preview and runtime inspector

Jump to install

Source facts

Repository
kurenai-studio/kurenai
Latest update
Aug 17, 2026
Category
Tools & Capabilities
GitHub stars
2
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/kurenai-studio/kurenai
Plugin: kurenai
Author: kurenai-studio

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

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.