dsh-worka

Worka

A persistent canvas for DeepSeek Harness.

Worka brings notes, tools, and ongoing agent work together on one desk.

Worka is a DSH plugin. Turn conversations into notes, build small interactive tools, and keep related work together on a spatial canvas. Your existing DSH host owns models, credentials, sessions, permissions, and upgrades.

What you can do

• Think on a canvas. Arrange, resize, pin, and group notes; keep ordinary conversations lightweight.
• Keep useful results. Save research, plans, and task progress in persistent notes with shared state.
• Build interactive notes. Notes can contain React views and background actions, with built-in Todo, weather, and execution-desk templates.
• Continue work across sessions. Connect notes, schedule actions, and follow progress without keeping a browser tab open.
• Use native DSH conversations. Model selection, streaming, attachments, approvals, and questions come from the host.

Worka is designed for a single user running trusted note code. Background work needs a running DSH host and an awake computer. Closing the browser does not stop it; stopping DSH does.

Install

You need:

• A working DSH Web profile, with your model provider configured in DSH.
• Node.js 24+ and Bun 1.3.11+ available to the host. Bun builds interactive notes.
• A compatible DSH 0.1.5 host. Development dependencies are pinned to 0.1.5-rc.2; this is a prerelease integration.

Install from a release archive, or build the same archive from source. The package is not yet published to npm. From a checkout of this repository:

bun install --frozen-lockfile
bun run pack

Install the resulting archive into your existing Web profile:

dsh plugin --profile web add ./artifacts/dsh-workbench-plugin-0.1.0.tgz
dsh --profile web

If DSH is already running, wait for active tasks to finish and restart it through your normal host workflow. Open /workbench/ on the same address as DSH, for example http://127.0.0.1:3080/workbench/ when the host uses port 3080. There is no separate Worka server or port.

Replace web with your existing Web profile name. A bare new profile may not include the Web services this plugin needs; follow the DSH profile documentation to set up the host first.

Try it

Click an empty area of the canvas and ask:

Create an ideas note with two items: organize my research and plan a small project. Make the items editable and let me add more.

Then:

Add a progress view to this note and keep its existing contents.

Chat remains a native DSH conversation. A persistent note is created when you ask for one. Editing note code produces a draft; activate it explicitly to apply the change.

System notes and extensions

The default package contains Todo, weather, and the execution desk. Templates are available to the agent; they are not automatically placed on your canvas. Ask it to create a note from a named template. Weather uses Open-Meteo after you choose a city, with its existing 30-minute refresh schedule; network-based location is used only when you choose it. The public endpoint has separate service terms.

Slack, Quip, and other service integrations are not bundled. Future extensions will live in separate GitHub repositories and install through DSH. This release does not add a marketplace or a general extension-registration API.

Configuration and storage

The bundle registers the Worka plugin and a SQLite backend in the host. Defaults:

Override the bundle in your profile's cordis.patch.yml, for example:

- id: workbench
  config:
    workspaceRoot: /absolute/path/to/projects
    bunPath: /absolute/path/to/bun
    desktopNotifications: true

When changing the storage location, update both workbench.dataRoot and workbench-sqlite.path. Keep one owner for each Worka database; do not point two running hosts at the same data directory.

Models and API keys are configured in DSH. Worka does not create a separate credential file or default model. Switching a default model affects new conversations; existing conversations use their native DSH model selector.

Upgrade and uninstall

Upgrade DSH using the installation method you originally chose. Worka does not download, launch, or upgrade a second host.

To update Worka, build a new archive and install it with the same dsh plugin --profile web add <archive> command, then restart the host when its tasks have finished.

To remove the plugin:

dsh plugin --profile web remove @dsh-workbench/plugin

Restart the host to unload it. Uninstalling does not intentionally delete your persistent Worka data.

Used the old standalone development launcher? Read Migration before changing hosts or data paths. Notes and native conversation history live in different stores.

Development

bun install --frozen-lockfile
bun run typecheck
bun run pack

Install the archive into a disposable DSH Web profile for integration checks. Rebuild and reinstall after changes; DSH remains the owner of the running process. The @deepseek-ai/dsh development dependency supplies a reproducible integration toolchain, not an application runtime shipped by Worka.

Run only the tests relevant to your change, for example:

bun test tests/integration/live-transcript.test.ts

See Contributing for packaging and verification, Authoring for note APIs, Templates for starting points, and Collaboration for cross-note work.

Status

Early-stage, prerelease software. Plugin installation and compatibility are checked against a pinned DSH version; compatibility with future host versions must be verified. A host restart does not resume arbitrary JavaScript call stacks or guarantee that an interrupted external operation can be repeated safely.

License

MIT.

Naming

The product is called Worka. The package name @dsh-workbench/plugin, /workbench/ route, and existing storage identifiers are retained for compatibility.