Introduction

When developing in the DeepSeek Harness (DSH) Work window, developers often need to switch windows frequently to confirm the current project name, branch, and change status. The omdsh-status plugin embeds the project name and Git status directly into the conversation header, to the left of the Session log export button, making this information easy to see at a glance.

Plugin Positioning

  • Plugin name: omdsh-status
  • Maintainer: omdsh-plugins
  • Category: Insight
  • Positioning: Displays the current project and Git status in the header of the DSH Work window conversation.

Core Features

  1. Conversation header status display: Displays the project name and Git status in the conversation header.
  2. Detailed change counts: Displays counts for the current branch, ahead/behind, staged, modified, untracked, and conflicts.
  3. API endpoint: Provides the GET /omdsh-status/status endpoint.
  4. No configuration required: No namespace configuration is needed; automatically reads the status of the working directory.

Installation and Enablement

Install using the official plugin center:

npx @omdsh-plugins/omdsh-plughub add omdsh-status

This plugin is licensed under the MIT License.

Typical Usage

  • Session with content: Displayed on the left side of the conversation header, formatted like omdsh-plugins ⎇ main ↑1 +2 ~3.
  • Blank session: When the session has not started yet, the status is displayed in the framework’s floating layer.
  • Non-Git repository: If the current directory is not in a Git repository, only the project name is displayed, with a tooltip hint.

Applicable Scenarios and Limitations

  • Chat mode: When using Chat mode (such as basemode + chatmode), the plugin does not display status because sessions in Chat mode do not belong to a specific project directory.
  • Code mode: Code mode replaces the conversation panel with a terminal, and the plugin automatically hides the status display.
  • Security mechanism: Git status parsing runs on the host machine and returns only count numbers; it does not send directory paths, diffs, or branch graphs to the browser.
  • Polling strategy: The plugin uses an efficient polling mechanism, caches results for 2 seconds, and re-requests every 4 seconds for visible pages.

Conclusion

omdsh-status reduces disruptions caused by context switching by providing intuitive project and Git status in the header. For more details, refer to the plugin directory or GitHub.