Skip to main content
K

dsh-nocco

khglobal/dsh-nocco

Describe a web system in chat and get a working one: admin panels, mobile apps, games. See it live beside the conversation, click any element to change it, start from your Excel data, and undo any step. Four design styles; sign-in and database built in.

Install

dsh plugin --profile web add github:khglobal/dsh-nocco

README

Nocco: Web application developer workbench

English | 中文

Nocco turns DeepSeek Harness into a workbench for building web applications. Describe the system you want; the agent builds it on your machine with the model you choose, and you watch it, steer it and undo it from one place. No account, no server, no extra cost beyond your own model.

The Nocco workbench: the conversation, a live preview at phone width, the palette, Inspect and the History timeline

Why not just ask DSH to build a web app?

DSH can write a web app without any plugin. Nocco changes what that work is like:

Plain DSHWith Nocco
Starting pointAn empty folder; the model picks a stack and sets it up each timeA tested app with sign-in, roles and a database already working
Seeing the resultYou start a dev server and open it yourselfA live preview opens beside the conversation, at desktop, tablet or phone width
Look and feelWhatever the model decides that dayFour design systems, a colour scheme, font and style chosen before you build; recolour afterwards in one click, without the model
Your existing dataThe model reads the file and retypes what it seesExcel and CSV rows are loaded into the app as they are; the model only sees the columns
Saying what to changeDescribe the element in wordsClick it in the preview
Going backNo way to restore filesA timeline of checkpoints with one-click restore
Checking the workThe agent tests by its own means, or you find the errorErrors from the page you are looking at go straight back to the agent

What you can do with it

  • Build from a sentence. Open Nocco in the sidebar, describe the system, press Build. The request goes straight to the agent, and the preview opens within about a minute while the rest is still being written.
  • Pick the look first. Ant Design for admin systems, shadcn for modern web apps, Vant for phones, Retro for the 1990s web; plus a colour scheme, a font and style options.
  • Start from your own files. Attach an Excel, CSV, Word or Markdown file and the system is built around it, with your rows as its starting data.
  • Real sign-in and real data. Every app has accounts, roles and a SQLite database from the first minute. Games and public pages are created open, with no sign-in screen.
  • Point, don't describe. Inspect lets you click an element in the preview; your next message tells the agent exactly which one, and which file draws it.
  • Undo anything. History keeps a checkpoint of each piece of work. Restore one with a click; the restore can itself be undone.
  • Talk before building. Switch to Discuss to plan the system with the agent before a single file is written.
  • Sharpen the request. Enhance prompt rewrites a rough idea into a clear brief with your model; voice input dictates it when DSH's voice input is on.

The Nocco page

The Nocco page: a prompt box with design system, colour scheme, file attach and the Discuss / Build switch, above a suggested system to build

The line under the box suggests systems to build. Your model writes the suggestions from the names of your workspace files and recent sessions; sample ideas are shown until it has.

Design systems

Ant Design · desktop adminshadcn · modern web
A sales dashboard built with the Ant Design systemA snake game built with the shadcn system
Retro · 1990s webVant · mobile
An ERP overview built with the Retro systemA store inspection app built with the Vant system

Every screenshot is an app the agent built from one request.

What it adds to DSH

  • Four design-system templates (Ant Design Vue, shadcn, Vant, and Retro, the look of a 1990s web page), each a Nuxt 3 app that already has sign-in, roles and a SQLite database.
  • Skill nocco (type /nocco in a session): how to build on the templates.
  • Tool nocco_scaffold: creates the app in an empty directory, installs its dependencies and returns the first admin account.
  • Tool nocco_preview: starts, stops and checks the app's local dev server, and applies the database schema whenever it changes.
  • Tool nocco_import: reads an Excel, CSV, TSV, Word, Markdown or text file you want a system built from. For table files the model sees the columns and a few rows, while every row is saved into the app as a data file, so your data is loaded as it is rather than retyped by the model.
  • Tool nocco_checkpoint: saves, lists and restores checkpoints of an app.
  • A Nocco page in the sidebar, in the look of the Nocco web app (light and dark, following DSH's theme): describe a system, pick a design system and a colour scheme, font and style, attach files to build from, optionally let your model sharpen the request with Enhance prompt, and press Build, which opens a session and sends the request. Switch to Discuss to talk the plan through before anything is built. When DSH's voice input is enabled and ready, a microphone button dictates into the box. It suggests systems to build, written by your model from the names of your workspace files and recent sessions (sample ideas are shown when no model is configured).
  • A preview tab beside the conversation with desktop, tablet and phone widths, reload, a palette picker that recolours the app without using the model, a History timeline of checkpoints with one-click restore, and Inspect: click an element in the preview to put it into your next message, so the agent knows exactly what you mean.

Requirements

DSH Desktop 0.2.2-rc.1 or newer in the 0.2 line. On the machine: Node 20 or newer, pnpm or npm, and git for checkpoints.

Install

The package name is @khglobal/dsh-nocco. In DSH Desktop there are three ways to install it:

  • Ask DSH. In any session, type:

    Install the plugin @khglobal/dsh-nocco
    

    The agent asks for your approval a few times and installs it. This works in the Standard and Creator modes.

  • Plugins page. Open Plugins in the sidebar, click Add plugin, enter @khglobal/dsh-nocco and click Install.

  • Plugin market. Once Nocco is listed in the community plugin index, open Plugins, go to the Discover tab and search for Nocco.

Nocco appears in the sidebar as soon as the install finishes.

For DSH's web version, the same package installs from the command line:

dsh plugin --profile web add @khglobal/dsh-nocco

Update

Open Plugins, then Nocco. When a newer version exists the page shows Update available; click Update.

Use

Open Nocco in the sidebar, describe the system and press Build; the request is sent to the agent straight away. Or type /nocco in any session. The agent asks for approval before it runs a tool.

Data and sign-in

The agent creates an app with sign-in required when it is a system for particular people, and with sign-in off when it is something anyone may open, such as a game or a public page. Ask it to change this at any time.

Each app keeps its data in a sqlite.db file in its own folder. The first admin account gets a random password when the app is created; the agent tells you what it is. Passwords are stored hashed, and the session secret lives in the app's .env, which is not committed.

Checkpoints and undo

Open History in the preview tab to see the app's checkpoints as a timeline. One is saved when the app is created, whenever the agent finishes a piece of work, and when you press Save checkpoint. Restore any of them with one click; the state before the restore is kept as a checkpoint too, so a restore can be undone. You can also ask the agent to go back.

Checkpoints cover the app's files, not its stored data: the database, .env and installed packages are not part of them. Code defines the tables, though, so restoring a version with different tables removes data in the tables or columns that version lacks. A copy of the database is saved under .nocco/backups/ before every restore (the last ten are kept). They are kept in a private git store under .nocco/ in the app folder, separate from any repository of your own, and need git to be installed.

Permissions

Nocco's tools work within the permissions of the session that calls them, the same ones DSH applies to its own file and shell tools.

  • Where files are written. An app is created, checkpointed and given imported rows only where the session may write. In DSH's workspace mode that is the session's working directory and the folders DSH has granted it. A path that reaches outside through a link is judged by where it leads.
  • Programs. Installing dependencies, the dev server, the database schema step and checkpoints run inside DSH's process sandbox, limited to the same place. The app's own code therefore cannot write outside its folder while it is being previewed.
  • Asking first. Anything outside those limits needs your approval in DSH for that one call, and the approval covers that one folder. This includes a read-only session, and a machine where DSH cannot confine programs. When approval is refused or cannot be asked for, nothing is written or started.
  • Full access. A session you have set to full access is not restricted, as with DSH's own tools.

Reading a file you ask to import follows DSH, which lets a session read files anywhere on the machine.

Privacy

Suggestions are generated by sending the names of files and folders at the top of your workspaces, and the titles of recent sessions, to the model you have configured in DSH. File contents are not read for suggestions. Enhance prompt sends the request you typed to the same model. Voice input is transcribed by DSH's own speech service on your machine. A file you attach on the Nocco page is copied to a folder under your system's temporary directory so the agent can read it. A file you ask the agent to import is read on your machine; what the model sees of it is described above. Nothing is sent anywhere else.

Limits

Process confinement has been tested on macOS. On Windows and Linux it relies on DSH's sandbox for those systems and has not been tested with Nocco.

No deploy or export. The generated app is ordinary code running a local dev server bound to 127.0.0.1. Its writes are confined as described under Permissions; its network access is not restricted.

Development

npm install
npm test        # builds, then runs the unit tests
npm run e2e     # real scaffold, install, Nuxt dev server and sign-in, per design system

Licence

MIT. The app template in resources/templates/ is MIT-0, so apps you build carry no attribution requirement.

Related plugins