Introduction

In the Web UI of DeepSeek Harness (DSH), session management involves archiving, deleting, moving workspaces, and migrating single Agent presets. dsh-session-manager is a DSH plugin that brings these operations into the Web UI and adds confirmation for irreversible operations.

What is it

hkkz9522/dsh-session-manager is maintained by hkkz9522 and is a DeepSeek Harness (DSH) plugin for safely managing sessions via the Web UI.

It is under the MIT license, with the package.json declaring version 0.4.1. This plugin is a Cordis plugin, declaring cordis >=4.0.0-rc <5 as a peer dependency.

Core Features

The following describes several verified capabilities.

  • Archive and unarchive sessions.
  • Delete sessions with explicit confirmation for irreversible actions.
  • Move sessions to a target workspace, preserving session history, title, archive status, and derived session relationships.
  • Migrate Agent preset for a single session.
  • Provide a Session manager in the sidebar to browse active and archived conversations; each row supports Open, Archive/Unarchive, Move, Delete, and Migrate preset.
  • Provide Archive/Unarchive, Move to workspace, and Delete conversation operations at the head of the current session.

Move Session

Moving a session changes its stored cwd; subsequent tool calls will run in the target workspace.

If the session being moved is currently running, the plugin will first interrupt and close the session, then automatically refresh the sidebar.

Delete Session

Deleting a session is permanent. The delete action requires explicit confirmation.

Preset Migration

Preset migration only changes session metadata and does not alter message history, files, or the selected workspace.

This feature handles only one session at a time and does not include batch migration operations. Subagents and transient blank-session placeholders are excluded from destructive or migration operations.

Installation and Enablement

The following introduces the installation commands. You can install from npm or from GitHub.

dsh plugin --profile web add npm:dsh-session-manager

dsh plugin --profile web add github:hkkz9522/dsh-session-manager

After installation, restart the DSH Web. If the browser is still loading the old client bundle, perform a hard refresh:

Ctrl+Shift+R

Typical Usage

Migrating Presets in UI

  1. Open Session manager.
  2. Locate the target session and select Migrate preset.
  3. Select a currently available target preset and confirm.

Calling Local Interface to Migrate Presets

Below is an example of migrating a session to standard:

curl -s -X POST http://127.0.0.1:3080/session-manager/api/preset-migrate \
  -H 'content-type: application/json' \
  -d '{"sessionId":"session-...","toPreset":"standard"}'

The sessionId in the example should be replaced with the actual session identifier.

Applicable Scenarios and Notes

Suitable for developers who need to manage sessions in the DSH Web UI. If you need to archive, delete, move across workspaces, or simply migrate a specific Agent preset for a single session, you can use this plugin.

Notes before use:

  • Deleting a session is permanent; confirm the target session before operating.
  • Moving a session changes the stored cwd; subsequent tool calls will run in the target workspace.
  • Moving a running session will interrupt and close it first, then refresh the sidebar.
  • Preset migration only changes session metadata and will not change message history, files, or the selected workspace.
  • Subagents and transient blank-session placeholders are not within the scope of destructive or migration operations.
  • This plugin does not have batch migration operations.
  • The plugin runs with the permissions of the current dsh process. It is recommended to check the source code and the MIT license before installation.

Conclusion

After the steps above, dsh-session-manager can centralize session management operations in the DSH Web UI: archiving, deleting, moving, and single preset migration all have clear entry points.

Repository address:

https://github.com/hkkz9522/dsh-session-manager