ARIS OS · install guide

Bring the machine to life.

ARIS OS ships as a plugin for the DeepSeek Harness. Install it into a profile, boot the web GUI, and the shell is live — telemetry left bar, world view, workspace filesystem, terminal composer — around the surface you already use.

0 · Requirements

Node ^22.19.0 or >=24.0.0, pnpm on PATH.
A deepseek-harness checkout built from source — you run its CLI as pnpm dsh ... (there is no global dsh unless you installed one).
Nothing else. Installation writes only to ~/.dsh (profile data) and your own machine — the harness checkout is never modified.

1 · Quick start

Add the plugin to the web profile

The plugin is published to npm as @danielng23/dsh-edex-ui.

pnpm dsh plugin --profile web add @danielng23/dsh-edex-ui

Boot the GUI

pnpm dsh web

The eDEX-style shell mounts over the default GUI. Open the served address and the machine is awake.

Purely additive. The shell overlays the original surface — nothing is disabled or replaced. Unload the plugin and the stock layout is restored exactly. Your theme preference is never touched.

2 · What you get

Package	Side	Role
`bundle`	—	Installable bundle (`cordis.patch.yml`)
`ui-edex`	client	The shell frame and all panels
`ui-theme-terminal`	client	Appearance → Terminal theme row
`host/system-metrics`	host	System telemetry RPC endpoints

3 · Running from the source checkout

To run the local checkout instead of the npm release (for development), add the bundle with a file: path — its file: dependency specs link the local sub-packages:

pnpm dsh plugin --profile web add file:/path/to/dsh-edex-ui/packages/bundle

Then build the workspace and link the harness's type packages for compilation:

pnpm install
./scripts/link-harness.sh          # symlinks @deepseek-ai/* from a sibling checkout
pnpm bundle                        # tsdown → dist bundles
pnpm dsh web

If the harness checkout lives somewhere other than ../deepseek-harness, point the linker at it:

DSH_HARNESS=/path/to/deepseek-harness ./scripts/link-harness.sh

4 · Development layout

The local workflow runs up to three instances side by side:

Port	Runs
`3080`	Baseline harness GUI
`3081`	npm-published plugin
`3083`	Local checkout (fast iteration)

Iterate on the local instance: edit a packages/* source file, rebuild, reload — the shell frame and panels hot-refresh without touching the other instances.

5 · Configuration

Theme Color — Settings → General → Theme Color. One accent in, a full CRT family out: terminal green, amber, cyan, violet, blue — or your own hex.
Workspace-follow — the filesystem browser and the ~/<workspace> prompt track the active conversation automatically.
Fullscreen — a toggle in the workspace browser header drives the browser Fullscreen API for the whole canvas.

6 · Uninstall / revert

Remove the plugin from the profile and the stock surface returns untouched:

pnpm dsh plugin --profile web remove @danielng23/dsh-edex-ui

Because the shell is an overlay registered into a slot, unloading restores the original layout frame, theme tokens, and composer exactly as they were.

Full development workflow: github.com/ph4310822/dsh-edex-ui ↗