Introduction

The DeepSeek Harness (DSH) sidebar treats the two-level structure of sessions and workspaces differently. Sessions are sorted by updated within a group by default and automatically move to the top when there is new activity. However, the order of the workspaces themselves comes from the workspaceIds array, which reflects the manual drag-and-drop order and does not respond to actual work content. If you want “the project you are currently working on to float to the top,” the missing part is only at the workspace level. dsh-workspace-promote is designed to fill this gap.

What This Is

dsh-workspace-promote is a DSH host plugin maintained by bobobo2026. Its core function is to move the corresponding workspace to the top of the sidebar when you submit a task. Once the task begins executing, the sidebar remains unchanged until the next submission.

Core Features

  1. Promote the workspace to the top when a task is submitted.
  2. Do not rearrange the sidebar while a task is running.
  3. Respond only to human-submitted prompts (user/message events), ignoring plugin events and tool results.
  4. Use no state file and persist changes by updating workspaceIds.
  5. The operation only affects workspace order, not sub-sessions or ungrouped sessions.

Installation and Activation

The installation command is as follows:

dsh plugin --profile web add dsh-workspace-promote

After installation is complete, you need to restart dsh web (host-plane plugins are mounted at startup).

Typical Usage

  1. After submitting a task, observe the sidebar to confirm whether the workspace has been promoted to the top.
  2. Check ~/.dsh/workspace-promote.log to verify trigger events.
  3. Restart dsh web to mount the plugin.

Audit Log

The plugin records its behavior to ~/.dsh/workspace-promote.log (following the DSH_HOME path). This is an append-only log used to confirm trigger timing:

2026-09-15T09:31:44.809Z boot pid=49220 trigger=human-prompt-only
2026-09-15T09:33:11.770Z promote workspace=039cce9b-... session=session-1ee5c45f-... from=a6680e0c-...

Use Cases and Notes

  • Use case: Developers who need to quickly switch to the current workspace.
  • Notes:
    • Potential conflict with manual drag-and-drop: If you manually drag Workspace B to the top and then submit Task A, A will be promoted to the top again.
    • It does not affect sub-sessions or ungrouped sessions.
    • MIT license.

Differences From Other Plugins

Its difference from dsh-workspace-sort lies in trigger timing and state management:

  • dsh-workspace-sort: Sorts by date and then freezes the order, suitable for keeping a fixed order throughout the day.
  • This plugin: Triggers on a “user submission action” and immediately promotes the workspace, with no state file, suitable for scenarios where the current project needs to stay at the top.

Conclusion

If you need the project you are currently working on to remain at the top of the sidebar, you can use this plugin.