DSH Metafolder Plugin

Visual and Host-backed meta-folders for the DeepSeek Harness sidebar.

Nest real workspace folders and individual sessions under named, collapsible groups — for example every Resonant OS project under one "Resonant OS" meta folder. The safe organization layer changes how sessions and workspace folders are visualised and persists through an optional Host service, with a localStorage compatibility fallback:

• workspace paths, permissions, and session working directories are untouched;
• workspace and session grouping is metadata-only and can be stored by the Host;
• physical workspace moves remain guarded until DSH exposes a supported path-migration API;
• ungrouping returns a folder to the main list unchanged;
• the AI's permissions stay attached to the real folder, because the real folder is what the plugin renders.

Features

• Meta-folders over the real workspace rows, with per-folder session counts.
• Drag and drop: drag a workspace or session row onto a meta folder to file it; drop it on the list background to take it out again.
• Host-backed assignments: when the optional remote.metafolder service is present, assignments persist through the Host; older compositions retain the localStorage fallback.
• Physical move boundary: actual workspace/project moves are intentionally guarded until DSH provides a workspace/session migration API or a dedicated atomic Host capability.
• Row menu: → <meta folder> to file, Remove from meta folder to unfile, plus rename / move up / move down, and delete workspace.
• Per-folder colour: pick it when you create the folder — an eight-swatch palette, the theme colour, or a custom colour — and change it any time from Rename meta folder. The colour tints the folder glyph, its label, and the drop-target outline.
• View options (the shipped menu, preserved): group by Workspace / Flat, order by Manual / Updated. Manual order honours the order already stored by the shipped browser (dsh.workspace.view.v5).
• Add workspace still works, from both the wide sidebar and the collapsed rail, via the composed directory-flow picker with a Host-picker fallback.
• Session search (local + Host index), rename / fork / archive per session, per-workspace new session.

Everything the shipped browser offered is still here — the meta-folder layer is an addition to the toolbar, not a replacement.

Requirements

• DeepSeek Harness >= 0.1.5-rc.1 on the web profile.
• The shipped @deepseek-ai/dsh-client-ui-sidebar and @deepseek-ai/dsh-client-ui-workspace client packages (the seat it shadows).
• Node ^22.19.0 || >=24.0.0 to build the browser half.

Install

One package, two halves:

file	role
lib/index.js	host half — registers nothing; mounting it is what makes the client-module scan read dsh.client
lib/client.js	browser half — shadows the sidebar.workspaces seat and renders the meta-folder browser
client.js	source of truth (dynamic-Cordis form, also usable with the cordis_define runtime tool)

lib/client.js is generated from client.js; regenerate and check it after editing:

npm run check     # build + syntax + export smoke test

As a web-profile package

ln -s "/path/to/DSH-Metafolder-Plugin" \
      ~/.dsh/profiles/web/node_modules/dsh-metafolder-plugin

then add to ~/.dsh/profiles/web/cordis.patch.yml:

- insert:
    - id: metafolder-plugin
      name: 'dsh-metafolder-plugin'

Restart dsh web. The module graph is composed at boot, so a page reload alone will not pick up a code change (and client-hmr is commonly disabled to avoid per-tab SSE connection exhaustion).

Registration note: a single slot takes one registration per priority and the lowest renders, so the seat is registered with priority: -1 to shadow the shipped browser at 0. Registering at the default 0 is rejected with "already has a registration at priority 0 … register at a different priority to shadow it".

Revert

Remove the insert row and the symlink, then restart dsh web:

rm ~/.dsh/profiles/web/node_modules/dsh-metafolder-plugin

Your groups stay in localStorage under dsh.wsmeta.v1 until you clear them, so uninstalling never touches a workspace.

Verified against

• @deepseek-ai/dsh-client-ui-workspace — sidebar.workspaces registration, the sidebar.workspaces.directoryFlow hole, WorkspaceBrowserProps.
• @deepseek-ai/dsh-client-ui-sidebar — owner share { wide, expandSidebar }.
• @deepseek-ai/dsh-api-workspace-controller / dsh-api-session-controller — workspace and session service methods and snapshot shapes.
• DSH physical move boundary: the remaining work for true physical moves requires an upstream DSH workspace/session migration API or a dedicated Host capability that atomically updates the filesystem, workspace registry, and session metadata.

MIT © 2026 Manolo Remiddi